共用方式為

SP_REGISTER_CONTROL_STATUSA 結構 （setupapi.h）

SP_REGISTER_CONTROL_STATUS 結構包含使用 RegisterDlls INF 指示詞註冊或取消註冊檔案的相關信息，以在 Windows 2000 上自我註冊 DLL。

SetupInstallFromInfSection 傳送 SPFILENOTIFY_STARTREGISTRATION 或 SPFILENOTIFY_ENDREGISTRATION 通知給回呼例程時，呼叫端必須提供 msgHandler 參數中 SP_REGISTER_CONTROL_STATUS 結構的指標。

語法

typedef struct _SP_REGISTER_CONTROL_STATUSA {
  DWORD cbSize;
  PCSTR FileName;
  DWORD Win32Error;
  DWORD FailureCode;
} SP_REGISTER_CONTROL_STATUSA, *PSP_REGISTER_CONTROL_STATUSA;

成員

cbSize

FileName

要註冊或取消註冊之檔案的完整路徑。

Win32Error

若為SPFILENOTIFY_STARTREGISTRATION通知，則不會使用此成員，而且應該設定為 NO_ERROR。 針對SPFILENOTIFY_ENDREGISTRATION通知，請將 設定為 系統錯誤碼。

FailureCode

對於SPFILENOTIFY_STARTREGISTRATION通知，不會使用此成員，而且應該設定為 SPREG_SUCCESS。 針對SPFILENOTIFY_ENDREGISTRATION通知，將 設定為下列其中一個指出註冊結果的失敗碼。

價值 意義
SPREG_SUCCESS
 已成功註冊或取消註冊檔案。 未使用 WinError。
SPREG_LOADLIBRARY
 檔案的 LoadLibrary 失敗。 WinError 包含元件的擴充錯誤碼。
SPREG_GETPROCADDR
 檔案的 GetProcAddress 失敗。 WinError 包含元件的擴充錯誤碼。
SPREG_REGSVR
 DLLRegisterServer 進入點傳回失敗。 WinError 包含元件的擴充錯誤碼。
SPREG_DLLINSTALL
 DLLInstall 進入點傳回失敗。 WinError 包含元件的擴充錯誤碼。
SPREG_TIMEOUT
 檔案註冊或取消註冊超過指定的逾時。 WinError 設定為 ERROR_TIMEOUT。
SPREG_UNKNOWN
 檔案註冊或取消註冊失敗，原因不明。 WinError 表示元件的擴充錯誤碼。

言論

注意

setupapi.h 標頭會將SP_REGISTER_CONTROL_STATUS定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 setupapi.h

另請參閱

概觀

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

結構

  • Last updated on