ResUtilSetPropertyTable 関数 (resapi.h)

プロパティ テーブルのプロパティ リストに基づいて、クラスター データベースのプロパティを設定します。

構文

DWORD ResUtilSetPropertyTable(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [out, optional] LPBYTE                       pOutParams
);

パラメーター

[in] hkeyClusterKey

設定するプロパティの場所を識別するクラスター データベース キー。

[in] pPropertyTable

設定するプロパティを記述 するRESUTIL_PROPERTY_ITEM 構造体の配列へのポインター。

Reserved

予約済み。

[in] bAllowUnknownProperties

不明なプロパティを受け入れるかどうかを示します。 このパラメーターは、受け入れる必要がある場合は TRUE に設定され、受け入れられない場合は FALSE に 設定されます。

[in] pInPropertyList

プロパティ リストを含む入力バッファーへのポインター。

[in] cbInPropertyListSize

cbInPropertyList が指す入力バッファーのサイズ (バイト単位)。

[out, optional] pOutParams

返されたデータを保持する パラメーター ブロック へのポインター。 指定した場合、パラメーターは入力バッファー内のものと異なる場合にのみ書き込まれます。

戻り値

操作が成功した場合、関数は ERROR_SUCCESSを返します。

操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。

リターン コード 説明
ERROR_BAD_ARGUMENTS
 1 つ以上の入力パラメーターが無効でした。
ERROR_INSUFFICIENT_BUFFER
 cbInPropertyListSize で指定された入力バッファーのサイズが小さすぎます。
ERROR_INVALID_DATA
 pInPropertyList が指す入力バッファーが NULL、プロパティ名が無効、またはプロパティ値が小さすぎます。
ERROR_INVALID_PARAMETER
 pPropertyTable が指すプロパティ テーブル内のプロパティの構文、形式、または型が正しくないか、プロパティが読み取り専用であり、設定できません。

注釈

プロパティ テーブルに指定された値がクラスター データベースに既に存在する場合、値は書き込まれません。 すべての値を強制的に書き込む方法については、「 ResUtilSetPropertyTableEx」を参照してください。

次のリソース DLL エントリ ポイント関数から ResUtilSetPropertyTable を呼び出さないでください。

ResUtilSetPropertyTable は、他のリソース DLL エントリ ポイント関数またはワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム Windows
ヘッダー resapi.h
Library ResUtils.lib
[DLL] ResUtils.dll

こちらもご覧ください

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTableEx

  • Last updated on