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

内部使用専用に予約されています。 0 に設定する必要があります。

[in, optional] hMachine

指定した デバイス セットアップ クラス プロパティを設定するリモート コンピューターへのハンドル。 このパラメーターは省略可能です。 NULL に設定すると、プロパティはローカル コンピューターで設定されます。

戻り値

操作が成功した場合、 CM_Set_Class_Registry_Property は CR_SUCCESS を返します。 それ以外の場合、関数は Cfgmgr32.h で定義されている他のCR_Xxx 状態コードのいずれかを返します。

解説

Buffer が NULL の場合は、ulLength を 0 に設定する必要があります。

ulLength が 0 に設定されている場合、この関数は プロパティを削除します。

Buffer が NULL に設定されておらず、ulLength が 0 に設定されていない場合、指定された値は ulProperty で指定されたプロパティのREG_Xxx データ型の正しいサイズである必要があります。

要件

サポートされている最小のクライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	cfgmgr32.h (Cfgmgr32.h を含む)
Library	Cfgmgr32.lib

関連項目

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty