CM_Get_Device_Interface_List_SizeA函式 (cfgmgr32.h)
CM_Get_Device_Interface_List_Size函式會擷取必須傳遞至CM_Get_Device_Interface_List函式的緩衝區大小。
語法
CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeA(
[out] PULONG pulLen,
[in] LPGUID InterfaceClassGuid,
[in, optional] DEVINSTID_A pDeviceID,
[in] ULONG ulFlags
);
參數
[out] pulLen
呼叫端提供的指標,指向接收緩衝區所需長度,以字元為單位的位置,以保存CM_Get_Device_Interface_List所傳回的多個 Unicode 字串串。
[in] InterfaceClassGuid
提供識別 裝置介面類別的 GUID。
[in, optional] pDeviceID
呼叫端提供的指標,指向代表 裝置實例標識碼的NULL終止字元串。 如果指定,函式會針對指定的類別,擷取裝置所支援之裝置介面的符號連結名稱長度。 如果此值為 NULL,或指向長度為零的字串,則函式會擷取屬於指定類別之所有介面的符號連結名稱長度。
[in] ulFlags
包含下列其中一個呼叫端提供的旗標:
值 | 意義 |
---|---|
|
函式提供清單的大小,其中包含與符合指定 GUID 和裝置實例識別碼之所有裝置相關聯的裝置介面。 |
|
函式提供清單的大小,其中包含與目前使用中裝置相關聯的裝置介面,以及符合指定 GUID 和裝置實例識別碼的裝置介面。 |
傳回值
如果作業成功,函式會 傳回CR_SUCCESS。 否則,它會傳回其中一個錯誤碼,其中 CR_ 前置詞,如 Cfgmgr32.h 中所定義。
備註
注意
cfgmgr32.h 標頭會將CM_Get_Device_Interface_List_Size定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | Universal |
標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
程式庫 | Cfgmgr32.lib |
Dll | CfgMgr32.dll |