CM_Set_Class_Registry_PropertyA函式 (cfgmgr32.h)

CM_Set_Class_Registry_Property函式會設定或刪除裝置安裝類別的屬性。

語法

CMAPI CONFIGRET CM_Set_Class_Registry_PropertyA(
  [in]           LPGUID   ClassGuid,
  [in]           ULONG    ulProperty,
  [in, optional] PCVOID   Buffer,
  [in]           ULONG    ulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

參數

[in] ClassGuid

GUID 的指標，表示要設定屬性的裝置安裝類別。

[in] ulProperty

ULONG 類型的值，識別要設定的屬性。 這個值必須是 CM_Get_Class_Registry_Property 函式之ulProperty參數所描述的其中一個CM_CRP_Xxx值。

[in, optional] Buffer

緩衝區的指標，其中包含屬性資料。 此參數是選擇性的，而且可以設定為 Null。 如需設定此參數和對應ulLength參數的詳細資訊，請參閱下列一節。

[in] ulLength

ULONG 類型的值，指定屬性資料的大小，以位元組為單位。

[in] ulFlags

已保留供內部使用。 必須設定為零。

[in, optional] hMachine

用來設定指定 裝置安裝類別屬性之遠端電腦的控制碼。 這是選擇性參數。 如果設定為 Null，則會在本機電腦上設定 屬性。

傳回值

如果作業成功， CM_Set_Class_Registry_Property 會傳回CR_SUCCESS。 否則，函式會傳回Cfgmgr32.h中定義的另一個CR_Xxx狀態碼。

備註

如果 Buffer 為 Null， ulLength 必須設定為零。

如果 ulLength 設定為零，函式會刪除 屬性。

如果Buffer未設定為Null且ulLength未設定為零，則提供的值必須是ulProperty中所指定屬性之REG_Xxx資料類型的正確大小。

規格需求

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

另請參閱

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty