RegisterApplicationRestart

アプリケーションのアクティブなインスタンスを再起動用に登録する。

RegisterApplicationRestart pwzCommandline, dwFlags

pwzCommandline : [wstr] アプリケーションが再起動される際のコマンドライン引数を指定する Unicode 文字列へのポインタ。指定可能なコマンドラインの最大サイズは RESTART_MAX_CMD_LINE 文字である。コマンドラインには実行可能ファイル名を含めてはならない。関数が追加する。このパラメータが NULL または空文字列の場合、以前に登録されたコマンドラインは削除される。引数に空白が含まれる場合は引数を引用符で囲む。
dwFlags : [int] 

(プラグイン / モジュール : kernel32.dll)

解説

アプリケーションのアクティブなインスタンスを再起動用に登録する。

[戻り値]
この関数は成功時に S_OK を返すか、次のエラーコードのいずれかを返す。
（以下省略）

[備考]

再起動のための最初の登録は、アプリケーションが未処理例外に遭遇したり無応答になる前に行う必要がある。その後、コマンドラインを更新するために復旧コールバック内からこの関数を呼び出すことができる。更新される
Windows アプリケーションの場合、この関数を呼び出す最後の機会は WM_QUERYENDSESSION
メッセージの処理中である。更新されるコンソールアプリケーションの場合、登録はインストーラがアプリケーションをシャットダウンしようとする前に行う必要がある(登録は常に最新に保つ必要がある。CTRL_C_EVENT
通知の処理中にこの関数を呼び出すことはできない)。再起動を登録していてアプリケーションが未処理例外に遭遇したり応答しなくなった場合、ユーザにアプリケーションを再起動する機会が提供される。ユーザの同意なしにアプリケーションが自動的に再起動されることはない。ただし、アプリケーションが更新されて再起動を必要とする場合、アプリケーションは自動的に再起動される。循環的な再起動を防ぐため、システムはアプリケーションが最低
60
秒以上実行されていた場合にのみ再起動する。更新がコンピュータ再起動を必要とする場合にアプリケーションが再起動されるには、インストーラは
EWX_RESTARTAPPS フラグを設定して ExitWindowsEx 関数を、または SHUTDOWN_RESTARTAPPS
フラグを設定して InitiateShutdown 関数を呼び出す必要がある点に注意。

情報