SetupDiCreateDeviceInfoListExA 函式 （setupapi.h）
語法
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），則此集合或其任何元素的所有後續作業都必須使用支援裝置資訊集與遠端元素的例程。 SetupDiXxx 例程未提供這項支援，例如 SetupDiCallClassInstaller，在其參考頁面中具有該效果的語句。
注意
setupapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetupDiCreateDeviceInfoListEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Microsoft Windows 2000 和更新版本的 Windows 中提供。 |
| 目標平臺 | 桌面 |
| 標頭 | setupapi.h （包括 Setupapi.h） |
| 連結庫 | Setupapi.lib |