CM_Get_Class_Property_ExW函式 (cfgmgr32.h)

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

CM_Get_Class_Property_ExW函式會擷取針對裝置介面類別別或裝置設定類別所設定的裝置屬性。

語法

CMAPI CONFIGRET CM_Get_Class_Property_ExW(
  [in]      LPCGUID          ClassGUID,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags,
  [in]      HMACHINE         hMachine
);

參數

[in] ClassGUID

識別 裝置介面類別別 或 裝置安裝類別 的 GUID 指標，用來擷取針對裝置類別設定的裝置屬性。 如需指定類別類型的相關資訊，請參閱 ulFlags 參數。

[in] PropertyKey

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

[out] PropertyType

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

[out] PropertyBuffer

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

[in, out] PropertyBufferSize

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

[in] ulFlags

類別屬性旗標：

CM_CLASS_PROPERTY_INSTALLER

ClassGUID 會指定裝置安裝類別。 請勿與CM_CLASS_PROPERTY_INTERFACE結合。

CM_CLASS_PROPERTY_INTERFACE

ClassGUID 指定裝置介面類別別。 請勿與CM_CLASS_PROPERTY_INSTALLER結合。

[in] hMachine

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

傳回值

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

備註

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

規格需求

另請參閱

CM_Connect_Machine

SetupDiGetClassProperty

SetupDiGetClassPropertyEx