SPFILENOTIFY_ENDREGISTRATION メッセージ

RegisterDlls INF ディレクティブを使用して DLL を自己登録する場合、SetupInstallFromInfSection の呼び出し元は、登録または登録解除時に各ファイルで通知を受け取ることがあります。 ファイルの登録または登録解除後にコールバック ルーチンにSPFILENOTIFY_ENDREGISTRATION通知を 1 回送信するには、SetupInstallFromInfSectionFlags パラメーターに SPINST_REGISTERCALLBACKAWARE と SPINST_REGSVRを含めます。 登録解除の通知を送信するには、 Flags パラメーターにSPINST_REGISTERCALLBACKAWAREとSPINST_UNREGSVRを含めます。

SetupInstallFromInfSectionMsgHandler パラメーターで指定されるコールバック ルーチンは、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 へのポインターに設定する必要があります。

戻り値

通知を受け取った後、コールバック関数は次のいずれかの値を返す場合があります。

リターン コード 説明
FILEOP_ABORT
INF セクションの処理を停止します。
FILEOP_DOIT
INF セクションの処理を続行します。
FILE_SKIP
INF セクションの処理を続行する

要件

要件
サポートされている最小のクライアント
Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ]
Header
Setupapi.h

関連項目

概要

通知

SetupInstallFromInfSection

SPFILENOTIFY_STARTREGISTRATION