SetupDiRegisterCoDeviceInstallers 函式 (setupapi.h)

  • 發行項

SetupDiRegisterCoDeviceInstallers 函式是DIF_REGISTER_COINSTALLERS的默認處理程式。

語法

WINSETUPAPI BOOL SetupDiRegisterCoDeviceInstallers(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

參數

[in] DeviceInfoSet

裝置資訊集的句柄，其中包含代表要註冊共同安裝程式之裝置的裝置信息專案。 裝置資訊集不得包含任何遠端元素。

[in] DeviceInfoData

指定 DeviceInfoSet 中裝置資訊元素之SP_DEVINFO_DATA結構的指標。

傳回值

如果函式成功，SetupDiRegisterCoDeviceInstallers 會傳回 TRUE。 如果函式傳回 FALSE，請呼叫 GetLastError 以取得擴充錯誤資訊。

備註

SetupDiRegisterCoDeviceInstallers 的呼叫端必須是 Administrators 群組的成員。

注意 只有類別安裝程式應該呼叫 SetupDiRegisterCoDeviceInstallers ，而且只有在類別安裝程式必須在 SetupDiRegisterCoDeviceInstallers 完成預設共同安裝程式註冊作業之後才執行共同安裝程式註冊作業。 在這種情況下，當安裝程式處理DIF_REGISTER_COINSTALLERS要求時，類別安裝程序必須直接呼叫 SetupDiRegisterCoDeviceInstallers 。 如需呼叫預設處理程式的詳細資訊，請參閱呼叫預設 DIF 程式代碼處理程式式。
 
SetupDiRegisterCoDeviceInstallers 會讀取 DeviceInfoData 所指定裝置的 INF 檔案，並建立登錄專案來註冊 INF 檔案中所列的任何裝置特定共同安裝程式。 共同安裝程式列在 INF DDInstall.CoInstallers 區段中。 除非已設定DI_NOFILECOPY旗標，否則此函式也會複製共同安裝程序的檔案。

如果沒有選取驅動程式，或裝置有適用於 Windows 9x 或的 InF 檔案，則此函式不會註冊任何共同安裝程式。

註冊新的裝置特定共同安裝程式會使裝置安裝程式目前的共同安裝程式清單失效。 成功註冊之後，裝置安裝程式會更新其共同安裝程式清單。

此函式只會註冊裝置特定的共同安裝程式，而不是類別共同安裝程式。

如需如何寫入和註冊裝置特定共同安裝程式的詳細資訊，請參閱 撰寫共同安裝程式。

DeviceInfoSet 指定的裝置信息必須只包含本機計算機上的元素。

規格需求

需求 值
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 setupapi.h (包括 Setupapi.h)
程式庫 Setupapi.lib
Dll Setupapi.dll

另請參閱

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller