SetClusterQuorumResource 函式 (clusapi.h)

發行項
02/26/2024

建立資源作為叢集的仲裁資源。 PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE類型會定義此函式的指標。

語法

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

參數

[in] hResource

新仲裁資源的句柄;或 dwMaxQuoLogSizeCLUS_NODE_MAJORITY_QUORUM時的現有仲裁資源。

[in, optional] lpszDeviceName

決定叢集服務將用來維護新仲裁資源上仲裁檔案的驅動器號和路徑。傳遞以 Null 終止的 Unicode 字串或 NULL，如下所示。

如果您在路徑中指定驅動器號，叢集服務會確認驅動器號參考新仲裁資源上的有效分割區。
如果您未在路徑中指定驅動器號，叢集服務會在新的仲裁資源上使用預設磁碟分區， (請參閱下方) 。
如果 為 NULL，叢集服務會使用預設磁碟分區和預設路徑名稱， (請參閱下方) 。

叢集服務會使用標幟為CLUSPROP_PIFLAG_DEFAULT_QUORUM分割區作為預設分割區， (請參閱CLUSPROP_PARTITION_INFO) ，或者，如果找不到旗標，則新仲裁資源上的第一個可用的 NTFS 磁碟分區。

針對預設路徑名稱，如果存在，叢集服務會使用先前的路徑名稱;否則會使用「MSCS」。。

[in] dwMaxQuoLogSize

仲裁類型值。指定列出的三個常數之一。當您指定 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
程式庫	ClusAPI.lib
Dll	ClusAPI.dll

另請參閱

GetClusterQuorumResource

共用方式為