SetClusterQuorumResource 関数 (clusapi.h)

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

構文

DWORD SetClusterQuorumResource(
  [in]           HRESOURCE hResource,
  [in, optional] LPCWSTR   lpszDeviceName,
  [in]           DWORD     dwMaxQuoLogSize
);

パラメーター

[in] hResource

新しいクォーラム リソースへの処理。dwMaxQuoLogSize がCLUS_NODE_MAJORITY_QUORUMされている場合は、既存のクォーラム リソース。

[in, optional] lpszDeviceName

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

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

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

[in] dwMaxQuoLogSize

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

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

戻り値

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

操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。

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

注釈

リソース DLL から SetClusterQuorumResource を呼び出さないでください。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム Windows
ヘッダー clusapi.h
Library ClusAPI.lib
[DLL] ClusAPI.dll

こちらもご覧ください

GetClusterQuorumResource