外部 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	エラー。 インストールを終了します。