共用方式為

CM_Get_Device_ID_List_ExW函式 (cfgmgr32.h)

  • 發行項

[從 Windows 8 和 Windows Server 2012 開始，此函式已被取代。 請改用 CM_Get_Device_ID_List 。]

CM_Get_Device_ID_List_Ex函式會擷取本機或遠端電腦上裝置實例的裝置實例標識符清單。

語法

CMAPI CONFIGRET CM_Get_Device_ID_List_ExW(
  [in, optional] PCWSTR   pszFilter,
  [out]          PZZWSTR  Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

參數

[in, optional] pszFilter

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

[out] Buffer

要接收一組 NULL 終止裝置實例識別符字串的緩衝區位址。 集合的結尾會由額外的 NULL終止。 呼叫 CM_Get_Device_ID_List_Size_Ex 時，應該取得所需的緩衝區大小。

[in] BufferLen

由呼叫端提供的緩衝區長度，以字元為單位，由 Buffer 所指定的緩衝區。

[in] ulFlags

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

[in, optional] hMachine

呼叫端提供的機器句柄，是從先前呼叫取得 來CM_Connect_Machine。

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

傳回值

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

備註

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

存取遠端電腦的功能已在 Windows 8 和 Windows Server 2012 和更新版本的作業系統中移除，因此您無法在這些版本的 Windows 上執行時存取遠端電腦。

規格需求

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