Share via

DIF_FINISHINSTALL_ACTION

  • [アーティクル]

DIF_FINISHINSTALL_ACTION 要求を使用すると、インストーラーは、他のすべてのデバイスインストール操作が完了した後、対話型の管理者コンテキストでインストール完了アクションを実行できます。

送信時

Windows 8 以降のバージョンでは、インストールの完了操作はデバイスのインストールの一部として自動的に実行されません。 デバイスのインストールの完了操作を完了するには、ユーザーがアクションセンターで [デバイスソフトウェアのインストールを完了する] をクリックしてインストールを完了する必要があります。

詳細については、「Finish-Install アクションの実行」を参照してください。

Windows 7 では、インストールの完了プロセスは、管理者の資格情報を持つユーザーのコンテキストでのみ、次のいずれかの時点で実行されます。

  • 次回、デバイスが接続されている間に管理者の資格情報を持つユーザーがログオンします。
  • デバイスが再アタッチされたとき。
  • ユーザーが [デバイスマネージャーでハードウェアの変更をスキャンする] を選んだとき。

ユーザーが管理者特権なしでサインインしている場合、Windows は管理者コンテキストでインストール完了アクションを実行するための同意と資格情報をユーザーに求めるプロンプトを表示します。

処理するユーザー

クラス共同インストーラー

処理できる

デバイス共同インストーラー

処理できる

クラスインストーラー

処理できる

インストーラーによる入力

DeviceInfoSet
デバイスを格納している デバイス情報セット への処理が提供されます。

DeviceInfoData
インストールされているデバイスを表す SP_DEVINFO_DATA 構造体へのポインター。

デバイスインストールパラメーター
DeviceInfoData に関連付けられているデバイス インストール パラメーター (SP_DEVINSTALL_PARAMS) 構造があります。

クラスインストールパラメーター
なし

インストーラーによる出力

デバイスインストールパラメーター
インストーラーは、インストールの完了にシステムの再起動が必要な場合、DI_N Enterprise Edition DREBOOT フラグを設定します。

インストーラーの戻り値

インストーラーは、次の表に示す値のいずれかを返します。

戻り値 説明

ERROR_DI_DO_DEFAULT

クラスインストーラー: インストーラーにインストール完了アクションがない、インストール完了アクションが正常に完了した、またはインストール完了アクションを正常に完了できないと判断しました。 デバイスのインストールでは、要求の既定の処理を実行する必要があります。

共同インストーラー: 共同インストーラーは、このエラー コードを返してはなりません。

NO_ERROR

クラス インストーラー: クラス インストーラーは、このエラーコードを返すべきではありません。 クラスインストーラーがこのエラー コードを返した場合、デバイスのインストールでは要求の既定の処理は実行されません。

共同クラスインストーラー: インストーラーにインストール完了アクションがない、インストール完了アクションが正常に完了した、またはインストール完了アクションを正常に完了できないと判断しました。

Win32 エラー コード

クラス インストーラーまたは共同インストーラー: インストーラーで、インストールの完了アクションの処理中にエラーが発生しました。デバイスのインストールは、次回デバイスが管理者のコンテキストで列挙されるときに、インストールの完了アクションの完了を試みる必要があります。

既定の DIF コードハンドラー

Windows 7 では、SetupDiFinishInstallAction が使用 されます。

Windows 8 以降のバージョンには既定の DIF コード ハンドラーがなく、SetupDiFinishInstallAction が削除されました。

コメント

デバイスのインストールは、[ERROR_DI_DO_DEFAULT] リターン コードまたは [NO_ERROR] リターンコードから、インストール完了アクションが実際に成功したかどうかを判断できないため、インストーラーは、インストーラー完了アクションのステータスをユーザーに通知する必要があります。

インストールの完了操作の詳細については、「デバイス インストール プロセスのインストール完了アクションとインストール完了アクションの実装」を参照してください。

DIF コードの一般的な情報については、「DIF コードの処理と既定の DIF コード ハンドラーの呼び出し」を参照してください。

要件

バージョン

Windows Vista から Windows 7 でサポートされます。

ヘッダー

 Setupapi.h (Setupapi.h を含む)

関連項目

SetupDiFinishInstallAction