ホーム › Networking.Clustering › PRESUTIL_SET_PROPERTY_PARAMETER_BLOCK

PRESUTIL_SET_PROPERTY_PARAMETER_BLOCK

コールバック

シグネチャ

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

パラメーター

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

公式ドキュメント

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

戻り値

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

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

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

解説(Remarks)

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

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

ResUtilSetPropertyParameterBlock は、上記以外のリソース 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)