CM_Set_Class_PropertyW函式 (cfgmgr32.h)

CM_Set_Class_Property函式會設定裝置安裝類別或裝置介面類別的類別屬性。

語法

CMAPI CONFIGRET CM_Set_Class_PropertyW(
  [in] LPCGUID          ClassGUID,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

參數

[in] ClassGUID

GUID 的指標，識別要為其設定裝置屬性的 裝置介面類別 或 裝置安裝類別 。 如需指定類別類型的詳細資訊，請參閱 ulFlags 參數。

[in] PropertyKey

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

[in] PropertyType

DEVPROPTYPE 型別值，表示裝置類別屬性的屬性數據類型識別碼。 若要刪除屬性，請將此屬性設定為 DEVPROP_TYPE_EMPTY。

[in] PropertyBuffer

緩衝區的指標，其中包含裝置類別屬性的屬性值。 如果要刪除屬性或數據，則必須將此指標設定為 NULL， 而且 PropertyBufferSize 必須設定為零。

[in] PropertyBufferSize

PropertyBuffer 緩衝區的大小，以位元組為單位。 如果 PropertyBuffer 設定為 NULL，PropertyBufferSize 必須設定為零。

[in] ulFlags

類別屬性旗標：

CM_CLASS_PROPERTY_INSTALLER

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

CM_CLASS_PROPERTY_INTERFACE

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

傳回值

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

備註

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

規格需求

另請參閱

SetupDiSetClassProperty