外部 UI での再起動マネージャーの使用
Windows インストーラーの開発者は、「再起動マネージャーでの Windows インストーラーの使用」で説明されているガイドラインに従って、再起動マネージャーで機能するようにインストール パッケージを準備できます。
MsiSetExternalUI または MsiSetExternalUIRecord 関数を呼び出して外部ユーザーインターフェイス ハンドラーを有効にするときに、INSTALLLOGMODE_RMFILESINUSE メッセージの種類を指定します。 Windows インストーラーは、再起動マネージャーをサポートする外部ユーザーインターフェイス ハンドラーから使用できるように、INSTALLMESSAGE_RMFILESINUSE メッセージを送信します。
INSTALLMESSAGE_RMFILESINUSE メッセージに含まれる情報は、外部ユーザー インターフェイス ハンドラーで処理する必要があります。 登録済みまたは内部のユーザー インターフェイスで INSTALLMESSAGE_RMFILESINUSE メッセージが処理されない場合、INSTALLMESSAGE_FILESINUSE メッセージと FilesInUse ダイアログ ボックスをサポートする既存の外部ハンドラーから使用できるように、Windows インストーラーは INSTALLMESSAGE_FILESINUSE メッセージを送信します。
外部ユーザー インターフェイスは、次の表に示す値を返すことができます。
| 外部 UI の戻り値 | Windows インストーラーが実行するアクション |
|---|---|
| IDOK | ユーザーが [OK] ボタンを押しました。 Windows インストーラーは再起動マネージャーに対して、現在使用中のファイルを保持するアプリケーションをシャットダウンして再起動するように要求します。 |
| IDCANCEL | [キャンセル] ボタンが押されました。 インストールを取り消します。 |
| IDIGNORE | [無視] ボタンが押されました。 無視してインストールを続行します。 インストールの最後に再起動が必要になります。 |
| IDNO | [いいえ] ボタンが押されました。 パッケージに MsiRMFilesInUse ダイアログ ボックスがある場合は、1610 メッセージを送信します。 詳細については、「Windows インストーラーのエラー メッセージ」を参照してください。 パッケージに MsiRMFilesInUse ダイアログ ボックスがない場合は、INSTALLMESSAGE_FILESINUSE メッセージを送信します。 |
| IDRETRY | [再試行] ボタンが押されました。 INSTALLMESSAGE_FILESINUSE メッセージを送信します。 |
| -1 | エラー。 インストールを終了します。 |