SPFILENOTIFY_ENDREGISTRATION メッセージ
RegisterDlls INF ディレクティブを使用して DLL を自己登録する場合、SetupInstallFromInfSection の呼び出し元は、登録または登録解除時に各ファイルで通知を受け取ることがあります。 ファイルの登録または登録解除後にコールバック ルーチンにSPFILENOTIFY_ENDREGISTRATION通知を 1 回送信するには、SetupInstallFromInfSection の Flags パラメーターに SPINST_REGISTERCALLBACKAWARE と SPINST_REGSVRを含めます。 登録解除の通知を送信するには、 Flags パラメーターにSPINST_REGISTERCALLBACKAWAREとSPINST_UNREGSVRを含めます。
SetupInstallFromInfSection の MsgHandler パラメーターで指定されるコールバック ルーチンは、PSP_FILE_CALLBACK型である必要があります。 Context パラメーターを SetupInstallFromInfSection で指定したのと同じ Context に設定します。 Notification パラメーターを SPFILENOTIFY_ENDREGISTRATION に設定します。
SPFILENOTIFY_ENDREGISTRATION
Param1 = (UINT_PTR) pointer to file information;
Param2 = (UINT_PTR) file registration or unregistration;
パラメーター
-
Param1
-
登録または登録解除されているファイルに関する情報を含む SP_REGISTER_CONTROL_STATUS 構造体へのポインター。 メンバー cbsize は構造体のサイズに設定する必要があります。 FileName は、登録されているファイルの完全修飾パスに設定する必要があります。 Win32Error は、拡張エラー コードを示す システム エラー コード に設定する必要があります。 FailureCode は、登録の結果を示す有効なエラー コードのいずれかに設定する必要があります。 有効なエラー コードについては、「 SP_REGISTER_CONTROL_STATUS」を参照してください。
-
Param2
-
ファイルが登録されている場合は、 Param2 を 0 以外の値へのポインターに設定する必要があります。 ファイルの登録が解除されている場合は、 Param2 を 0 へのポインターに設定する必要があります。
戻り値
通知を受け取った後、コールバック関数は次のいずれかの値を返す場合があります。
リターン コード | 説明 |
---|---|
|
INF セクションの処理を停止します。 |
|
INF セクションの処理を続行します。 |
|
INF セクションの処理を続行する |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
Header |
|