次の方法で共有

ResUtilSetPropertyTableEx 関数 (resapi.h)

  • [アーティクル]

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

構文

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を返します。

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

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

注釈

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

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

要件

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

こちらもご覧ください

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTable