ホーム › Networking.Clustering › PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE

PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE

コールバック

シグネチャ

DWORD PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE(
    HCLUSTER hCluster,
    LPWSTR lpszResourceName,
    DWORD* lpcchResourceName,
    LPWSTR lpszDeviceName,
    DWORD* lpcchDeviceName,
    DWORD* lpdwMaxQuorumLogSize
);

パラメーター

フィールド	型	説明
hCluster	HCLUSTER	既存のクラスターのハンドルです。
lpszResourceName	LPWSTR	クラスターのクォーラムリソースの名前を格納する、null で終わる Unicode 文字列へのポインターです。この名前は、クォーラムリソースの Name 共通プロパティから読み取られます。このパラメーターに NULL を渡さないでください。
lpcchResourceName	DWORD*	lpszResourceName バッファーのサイズを文字数で表した値へのポインターです。入力時には、終端の NULL を含め、バッファーが保持できる最大文字数を指定します。出力時には、終端の NULL を除いた、結果として得られた名前の文字数が格納されます。
lpszDeviceName	LPWSTR	クラスターサービスが管理するクォーラムログファイルの場所へのパスを格納する、null で終わる Unicode 文字列へのポインターです。このパラメーターに NULL を渡さないでください。
lpcchDeviceName	DWORD*	lpszDeviceName バッファーのサイズを文字数で表した値へのポインターです。入力時には、終端の NULL を含め、バッファーが保持できる最大文字数を指定します。出力時には、終端の NULL を除いた、結果として得られた名前の文字数が格納されます。
lpdwMaxQuorumLogSize	DWORD*	クォーラムリソースが管理しているログの最大サイズ (バイト単位) へのポインターです。このパラメーターに NULL を渡さないでください。

公式ドキュメント

クラスターのクォーラムリソースの名前を返します。PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE 型は、この関数へのポインターを定義します。

戻り値

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

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

戻り値	説明
ERROR_MORE_DATA	lpszResourceName または lpszDeviceName バッファーが、結果を保持するのに十分な大きさではありません。lpcchResourceName および lpcchDeviceName パラメーターは、終端の NULL を除いた結果の文字数を返します。

解説(Remarks)

lpcchName はバイト数ではなく文字数を指すこと、および返されるサイズには終端の NULL が含まれないことに注意してください。バッファーのサイズ指定の詳細については、データサイズの規則を参照してください。

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