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