TWURegisterRestart

The TWURegisterRestart function registers your (or a different) application for a restart when your application calls TWUCloseUpdate. This function is typically used after an in-place update, but can also be used if you want to start or restart a different application from a stand-alone update tool.

Note: The actual restart does not take place until TWUCloseUpdate is called; see the documentation of that function for details about the restart process.

URESULT TWURegisterRestart(
    TWUPDATE hUpdate,
    const TCHAR *pszAppPath,
    const TCHAR *pszOptions,
    DWORD dwFlags
);

Parameters

hUpdate

[Input] Handle of active update session, created with TWUOpenUpdate.

pszAppPath

[Input,optional] Fully qualified path to the application that must be [re]started during TWUCloseUpdate. If you pass NULL for this parameter, the current application's executable will be registered for restart; this is useful after an in-place upgrade.

pszOptions

[Input,optional] Any command line options to be passed to the restart application. Typically, this parameter is NULL, but if your application requires special processing after an upgrade, you can pass the corresponding command line options here.

dwFlags

[Input] Processing flags; see the section Processing flags below for details.

Return value

If the function succeeds, it returns ERROR_SUCCESS (0). If the function fails, it returns a nonzero Win32 API error code. You can use TWUGetErrorMessage to retrieve the error message that corresponds to the error code.

Processing flags

The dwFlags parameter can be a combination of the following values: