Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE

PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE

コールバック

シグネチャ

DWORD PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE(
    HRESOURCE hResource,
    LPWSTR lpszDeviceName,
    DWORD dwMaxQuoLogSize
);

パラメーター

フィールド型説明
hResourceHRESOURCE新しいクォーラムリソースへのハンドルです。dwMaxQuoLogSize が CLUS_NODE_MAJORITY_QUORUM の場合は、既存の クォーラムリソースへのハンドルを指定します。
lpszDeviceNameLPWSTR

新しいクォーラムリソース上でクラスターサービスがクォーラムファイルを保持するために使用する、ドライブ文字とパスを指定します。 次のように、null で終わる Unicode 文字列または NULL を渡します。

  • パスにドライブ文字を指定した場合、クラスターサービスは、そのドライブ文字が新しいクォーラムリソース上の 有効なパーティションを指しているかどうかを確認します。
  • パスにドライブ文字を指定しなかった場合、クラスターサービスは新しいクォーラムリソース上の既定のパーティションを 使用します (下記を参照)。
  • NULL の場合、クラスターサービスは既定のパーティションと既定のパス名を使用します (下記を参照)。
クラスターサービスは、既定のパーティションとして CLUSPROP_PIFLAG_DEFAULT_QUORUM のフラグが設定されたパーティションを使用します (CLUSPROP_PARTITION_INFO を参照)。このフラグが 見つからない場合は、新しいクォーラムリソース上で最初に利用可能な NTFS パーティションを使用します。

既定のパス名としては、クラスターサービスは以前のパス名が存在する場合はそれを使用し、存在しない場合は "MSCS" を使用します。

dwMaxQuoLogSizeDWORD

クォーラムの種類を表す値です。次に示す 3 つの定数のいずれかを指定します。CLUS_NODE_MAJORITY_QUORUM を指定する場合、 hResource は既存のクォーラムリソースを指している必要があります。

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

公式ドキュメント

リソースを クラスターの クォーラムリソースとして設定します。PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE 型は、この関数へのポインターを定義します。

戻り値

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

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

戻り値/値 説明
ERROR_RESOURCE_NOT_ONLINE
5004 (0x138C)
 クォーラムリソースがオンラインではありません。

解説(Remarks)

リソース DLL から SetClusterQuorumResource を呼び出さないでください。詳細については、 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)