CM_Get_Device_Interface_Property_ExW函式 (cfgmgr32.h)

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

CM_Get_Device_Interface_Property_ExW函式會擷取針對裝置介面設定的裝置屬性。

語法

CMAPI CONFIGRET CM_Get_Device_Interface_Property_ExW(
  [in]           LPCWSTR          pszDeviceInterface,
  [in]           const DEVPROPKEY *PropertyKey,
  [out]          DEVPROPTYPE      *PropertyType,
  [out]          PBYTE            PropertyBuffer,
  [in, out]      PULONG           PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

參數

[in] pszDeviceInterface

字串的指標，識別要從中擷取屬性的裝置介面實例。

[in] PropertyKey

DEVPROPKEY 結構的指標，表示要擷取之裝置介面屬性的裝置介面屬性索引鍵。

[out] PropertyType

DEVPROPTYPE 型別變數的指標，該變數會接收所要求裝置介面屬性的屬性數據類型標識碼。 property-data-type 標識符是基底數據類型標識符之間的位 OR，如果修改基底數據類型，則為 property-data-type 修飾詞。

[out] PropertyBuffer

接收要求之裝置介面屬性之緩衝區的指標。 只有在 緩衝區夠大，足以保存所有屬性值數據時，CM_Get_Device_Interface_Property_ExW才會擷取要求的屬性。 指標可以是 NULL。

[in, out] PropertyBufferSize

PropertyBuffer 緩衝區的大小，以位元組為單位。 如果 PropertyBuffer 設定為 NULL， 則必須將 *PropertyBufferSize 設定為零。 輸出時，如果緩衝區不夠大，無法保存所有屬性值數據， CM_Get_Device_Interface_Property_ExW 會以位元組為單位傳回 *PropertyBufferSize 中的數據大小。

[in] ulFlags

保留的。 必須設定為零。

[in, optional] hMachine

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

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

 

傳回值

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

備註

CM_Get_Device_Interface_Property_ExW 是 整合裝置屬性模型的一部分。

規格需求

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

另請參閱

CM_Connect_Machine

SetupDiGetDeviceInterfaceProperty