共用方式為

CM_Get_Device_ID_List_SizeA函式 (cfgmgr32.h)

  • 發行項

CM_Get_Device_ID_List_Size函式會擷取保存本機電腦裝置實例實例清單所需的緩衝區大小。

語法

CMAPI CONFIGRET CM_Get_Device_ID_List_SizeA(
  [out]          PULONG pulLen,
  [in, optional] PCSTR  pszFilter,
  [in]           ULONG  ulFlags
);

參數

[out] pulLen

接收值，表示所需的緩衝區大小，以字元為單位。

[in, optional] pszFilter

呼叫端提供的字元字串指標，指定計算機的裝置實例標識子集或 NULL。 請參閱下列 ulFlags 描述。

[in] ulFlags

其中一個選擇性的呼叫端提供的位旗標，指定搜尋篩選條件。 如果未指定旗標，函式會提供保留所有裝置實例之所有實例標識碼所需的緩衝區大小。 如需位旗標的清單，請參閱 CM_Get_Device_ID_List的 ulFlags 描述。

傳回值

如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

應該呼叫 CM_Get_Device_ID_List_Size 函式，以判斷 CM_Get_Device_ID_List所需的緩衝區大小。

pulLen 所指向之位置中提供的大小值保證代表足以保存所有裝置實例標識符字串和終止 NUL 的緩衝區大小。 提供的值實際上可能代表大於必要大小的緩衝區大小，因此請勿假設該值代表 CM_Get_Device_ID_List 將提供之字元字串的實際長度。

如需裝置實例標識碼的相關信息，請參閱 裝置識別字串。

注意

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

規格需求

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

另請參閱

CM_Get_Device_ID_List_Size_Ex