共用方式為


SPFILENOTIFY_STARTREGISTRATION訊息

使用 RegisterDlls INF 指示詞自我註冊 DLL 時, SetupInstallFromInfSection 的呼叫端可能會在註冊或取消註冊時收到每個檔案的通知。 若要在註冊檔案之前將SPFILENOTIFY_STARTREGISTRATION通知傳送至回呼常式一次,請在SetupInstallFromInfSectionFlags參數中包含SPINST_REGISTERCALLBACKAWARE加上SPINST_REGSVR。 若要傳送取消註冊的通知,請在 Flags 參數中包含SPINST_REGISTERCALLBACKAWARE加上SPINST_UNREGSVR。

SetupInstallFromInfSectionMsgHandler參數所指定的回呼常式必須是類型PSP_FILE_CALLBACK。 將CoNtext參數設定為SetupInstallFromInfSection中指定的相同CoNtext。 將 Notification 參數設定為 SPFILENOTIFY_STARTREGISTRATION

SPFILENOTIFY_STARTREGISTRATION
  Param1 = (UINT_PTR) pointer to file information;
  Param2 = (UINT_PTR) file registration or unregistration;
            

參數

Param1

SP_REGISTER_CONTROL_STATUS結構的指標,其中包含所註冊或取消註冊之檔案的相關資訊。 成員 cbsize 應該設定為 結構的大小。 FileName成員應該設定為所註冊檔案的完整路徑。 未使用Win32Error,而且應該設定為 NO_ERROR。 未使用 FailureCode ,且應設定為 SPREG_SUCCESS。

Param2

如果正在註冊檔案, Param2 應該設定為非零值的指標。 如果檔案正在取消註冊, Param2 應該設定為指標為零。

傳回值

收到通知之後,回呼函式可能會傳回下列其中一個值。

傳回碼 描述
FILEOP_ABORT
請勿註冊或取消註冊檔案,並停止處理 INF 區段。
FILEOP_DOIT
註冊或取消註冊檔案,並繼續處理 INF 區段。
FILE_SKIP
略過檔案的註冊或取消註冊,但繼續處理 INF 區段

規格需求

需求
最低支援的用戶端
Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限桌面應用程式]
標頭
Setupapi.h

另請參閱

概觀

通知

SetupInstallFromInfSection

SPFILENOTIFY_ENDREGISTRATION