CM_Get_DevNode_Property_ExW函式 (cfgmgr32.h)

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

CM_Get_DevNode_Property_ExW函式會擷取裝置實例屬性。

語法

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

參數

[in] dnDevInst

系結至本機電腦的裝置實例控制碼。

[in] PropertyKey

DEVPROPKEY結構的指標，表示所要求裝置實例屬性的裝置屬性索引鍵。

[out] PropertyType

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

[out] PropertyBuffer

接收要求之裝置實例屬性之緩衝區的指標。 只有在 緩衝區夠大，足以保存所有屬性值資料時，CM_Get_DevNode_Property_ExW才會擷取要求的屬性。 指標可以是 Null。

[in, out] PropertyBufferSize

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

[in] ulFlags

保留的。 必須設定為零。

[in, optional] hMachine

呼叫端提供的機器控制碼，是從先前呼叫取得 來CM_Connect_Machine。

傳回值

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

備註

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

規格需求

另請參閱

CM_Connect_Machine

SetupDiGetDeviceProperty