CM_Set_Class_Registry_PropertyW関数 (cfgmgr32.h)
CM_Set_Class_Registry_Property関数は、デバイス セットアップ クラスのプロパティを設定または削除します。
構文
CMAPI CONFIGRET CM_Set_Class_Registry_PropertyW(
[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