ホーム › Networking.Clustering › PRESUTIL_SET_PROPERTY_TABLE_EX

PRESUTIL_SET_PROPERTY_TABLE_EX

コールバック

シグネチャ

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

パラメーター

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

公式ドキュメント

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

戻り値

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

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

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

解説(Remarks)

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

ResUtilSetPropertyTableEx は、これら以外のリソース 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)