プロパティ テーブルのプロパティ リストに基づいて、クラスター データベースのプロパティを設定します。
構文
DWORD ResUtilSetPropertyTableEx(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
PVOID Reserved,
[in] BOOL bAllowUnknownProperties,
[in] const PVOID pInPropertyList,
[in] DWORD cbInPropertyListSize,
[in] BOOL bForceWrite,
[out, optional] LPBYTE pOutParams
);
パラメーター
[in] hkeyClusterKey
設定するプロパティの場所を識別するクラスター データベース キー。
[in] pPropertyTable
設定するプロパティを記述 するRESUTIL_PROPERTY_ITEM 構造体の配列へのポインター。
Reserved
予約済み。
[in] bAllowUnknownProperties
不明なプロパティを受け入れる必要があるかどうかを示します。 このパラメーターは、受け入れる必要がある場合は TRUE 、受け入れられない場合は FALSE に 設定されます。
[in] pInPropertyList
プロパティ リストを含む入力バッファーへのポインター。
[in] cbInPropertyListSize
cbInPropertyList が指す入力バッファーのサイズ (バイト単位)。
[in] bForceWrite
新しい値が既存の値と同じ場合でも、プロパティ値を強制的にクラスター データベースに書き込みます
[out, optional] pOutParams
返されたデータを保持する パラメーター ブロック へのポインター。 これがポインターである場合、入力バッファーと異なるパラメーターのみがパラメーター ブロックに書き込まれます。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。
| リターン コード | 説明 |
|---|---|
|
1 つ以上の入力パラメーターが無効でした。 |
|
cbInPropertyListSize で指定された入力バッファーのサイズが小さすぎます。 |
|
pInPropertyList が指す入力バッファーが NULL、プロパティ名が無効、またはプロパティ値が小さすぎます。 |
|
pPropertyTable が指すプロパティ テーブル内のプロパティの構文、形式、または型が正しくないか、プロパティが読み取り専用であり、設定できません。 |
注釈
次のリソース DLL エントリ ポイント関数から ResUtilSetPropertyTableEx を呼び出さないでください。
ResUtilSetPropertyTableEx は、他のリソース DLL エントリ ポイント関数またはワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |