共用方式為

CM_Get_Device_Interface_List_SizeW函式 (cfgmgr32.h)

  • 發行項

CM_Get_Device_Interface_List_Size函式會擷取必須傳遞至CM_Get_Device_Interface_List函式的緩衝區大小。

語法

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeW(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

參數

[out] pulLen

呼叫端提供的位置指標，該位置會接收緩衝區的必要長度，以字元為單位，以保存 CM_Get_Device_Interface_List所傳回的多個 Unicode 字串。

[in] InterfaceClassGuid

提供識別 裝置介面類別的 GUID。

[in, optional] pDeviceID

呼叫端提供的指標，代表 裝置實例標識碼的NULL終止字元串。 如果指定，函式會針對指定的類別，擷取裝置所支援之裝置介面的符號連結名稱長度。 如果此值為 NULL，或指向零長度字串，則函式會擷取屬於指定類別之所有介面的符號連結名稱長度。

[in] ulFlags

包含下列其中一個呼叫端提供的旗標：

值 意義
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES
 函式提供清單的大小，其中包含與符合指定 GUID 和裝置實例識別碼之所有裝置相關聯的裝置介面。如果有的話。
CM_GET_DEVICE_INTERFACE_LIST_PRESENT
 函式提供清單的大小，其中包含與目前使用中之裝置相關聯的裝置介面，以及符合指定 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

另請參閱

CM_Get_Device_Interface_List