CM_Set_Class_Property_ExW函式 (cfgmgr32.h)

發行項
08/22/2023

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

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

語法

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

參數

[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合併。

[in, optional] hMachine

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

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

傳回值

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

備註

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

規格需求


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

另請參閱

CM_Connect_Machine

SetupDiSetClassProperty

共用方式為