ホーム › Networking.Clustering › PRESUTIL_SET_PROPERTY_TABLE

PRESUTIL_SET_PROPERTY_TABLE

コールバック

シグネチャ

DWORD PRESUTIL_SET_PROPERTY_TABLE(
    HKEY hkeyClusterKey,
    RESUTIL_PROPERTY_ITEM* pPropertyTable,
    void* Reserved,
    BOOL bAllowUnknownProperties,
    void* pInPropertyList,
    DWORD cbInPropertyListSize,
    BYTE* pOutParams
);

パラメーター

フィールド	型	説明
hkeyClusterKey	HKEY	設定するプロパティの位置を示すクラスターデータベースキーです。
pPropertyTable	RESUTIL_PROPERTY_ITEM*	設定するプロパティを記述する RESUTIL_PROPERTY_ITEM 構造体の配列へのポインターです。
Reserved	void*	予約されています。
bAllowUnknownProperties	BOOL	不明なプロパティを受け入れるかどうかを示します。受け入れる場合はこのパラメーターに TRUE を、受け入れない場合は FALSE を設定します。
pInPropertyList	void*	プロパティリストを格納した入力バッファーへのポインターです。
cbInPropertyListSize	DWORD	cbInPropertyList が指す入力バッファーのサイズ (バイト単位) です。
pOutParams	BYTE*	返されたデータを格納するパラメーターブロックへのポインターです。指定した場合、パラメーターは入力バッファー内の値と異なる場合にのみ書き込まれます。

公式ドキュメント

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

戻り値

処理が成功した場合、この関数は ERROR_SUCCESS を返します。

処理が失敗した場合、この関数はシステムエラーコードを返します。返される可能性のあるエラーコードは次のとおりです。

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

解説(Remarks)

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

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

ResUtilSetPropertyTable は、これら以外のリソース DLL エントリポイント関数やワーカースレッドからであれば安全に呼び出せます。詳細については、 Function Calls to Avoid in Resource DLLs を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)