SetupDiCreateDeviceInfoListExA 函式 (setupapi.h)

SetupDiCreateDeviceInfoList 函式會在遠端或本機計算機上建立空的裝置資訊，並選擇性地將集合與裝置設定類別產生關聯。

語法

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

參數

[in, optional] ClassGuid

要與新建立之裝置資訊集建立關聯的裝置安裝類別 GUID 指標。 如果指定此參數，此類別的裝置只能包含在此裝置資訊集中。 如果此參數設定為 NULL，則裝置資訊集不會與特定裝置設定類別相關聯。

[in, optional] hwndParent

最上層視窗的句柄，用於與非裝置特定動作相關的任何使用者介面， (例如使用全域類別驅動程式清單的選取裝置對話框) 。 此句柄是選擇性的，可以是 NULL。 如果不需要特定的最上層視窗，請將 hwndParent 設定為 NULL。

[in, optional] MachineName

NULL 終止字串的指標，其中包含網路上計算機的名稱。 如果指定名稱，則只有該電腦上的裝置可以在此裝置資訊集中建立並開啟。 如果此參數設定為 NULL，則裝置資訊集適用於本機電腦上的裝置。

警告

從 Windows 8 和 Windows Server 2012 開始，不支援使用此函式來存取遠端電腦，因為已移除此功能。

Reserved

必須是 NULL。

傳回值

函式會在成功時，傳回空裝置資訊集的句柄。 否則，它會傳回INVALID_HANDLE_VALUE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

呼叫 SetupDiDestroyDeviceInfoList 時，此函式的呼叫端必須刪除已傳回的裝置資訊集。

如果裝置資訊集適用於遠端電腦上的裝置， (MachineName 不是 NULL) ，則此集合或其任何元素的所有後續作業都必須使用支援具有遠端元素之裝置資訊集的例程。 未提供此支援的 SetupDi Xxx 例程，例如 SetupDiCallClassInstaller，在其參考頁面中具有該效果的語句。

注意

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

規格需求

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

另請參閱

SetupDiCreateDeviceInfoList

SetupDiDestroyDeviceInfoList

SetupDiGetDeviceInfoListDetail