ホーム › Networking.Clustering › PRESUTIL_SET_PROPERTY_PARAMETER_BLOCK_EX

PRESUTIL_SET_PROPERTY_PARAMETER_BLOCK_EX

コールバック

シグネチャ

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

パラメーター

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

公式ドキュメント

パラメーターブロックからクラスターデータベースにプロパティを設定します。

戻り値

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

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

戻り値	説明
ERROR_INVALID_PARAMETER	pPropertyTable が指すプロパティテーブル内のプロパティの構文、形式、または型が正しくないか、プロパティが読み取り専用であるため更新できません。
ERROR_BAD_ARGUMENTS	1 つ以上の入力パラメーターが無効でした。

解説(Remarks)

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

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