ホーム › Networking.Clustering › PRESUTIL_SET_PRIVATE_PROPERTY_LIST

PRESUTIL_SET_PRIVATE_PROPERTY_LIST

コールバック

シグネチャ

DWORD PRESUTIL_SET_PRIVATE_PROPERTY_LIST(
    HKEY hkeyClusterKey,
    void* pInPropertyList,
    DWORD cbInPropertyListSize
);

パラメーター

フィールド	型	説明
hkeyClusterKey	HKEY	設定するプロパティの場所を示すクラスターデータベースキーです。
pInPropertyList	void*	設定するプロパティの名前と値を格納したプロパティリストを含む入力バッファーへのポインターです。
cbInPropertyListSize	DWORD	pInPropertyList が指す入力バッファーのサイズ (バイト単位) へのポインターです。

公式ドキュメント

クラスターオブジェクトのプライベートプロパティを設定します。

戻り値

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

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

戻り値	説明
ERROR_BAD_ARGUMENTS	入力パラメーターのうち 1 つ以上が無効でした。
ERROR_INVALID_DATA	プロパティのデータ長に問題がありました。
ERROR_INSUFFICIENT_BUFFER	pInPropertyList が指す入力バッファーが NULL でした。
ERROR_INVALID_PARAMETER	プロパティ名の構文が無効でした。

解説(Remarks)

ResUtilSetPrivatePropertyList ユーティリティ関数で設定されたプロパティは、プロパティリストで指定された名前のとおりに、対象オブジェクトの指定されたキーより下のクラスターデータベース領域に配置されます。プロパティ名に円記号 (\) が含まれている場合、各円記号の前にある文字列はサブキー名として解釈され、最後の円記号に続く最後の文字列は値名として解釈されます。

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

ResUtilSetPrivatePropertyList は、これら以外のリソース DLL エントリポイント関数やワーカースレッドからは安全に呼び出せます。詳細については、リソース DLL で呼び出しを避けるべき関数を参照してください。

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