SetClusterQuorumResource function

Establishes a resource as the quorum resource for a cluster. The PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE type defines a pointer to this function.

Syntax


DWORD WINAPI SetClusterQuorumResource(
  _In_     HRESOURCE hResource,
  _In_opt_ LPCWSTR   lpszDeviceName,
  _In_     DWORD     dwMaxQuoLogSize
);

typedef DWORD (WINAPI *PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE)(
    _In_     HRESOURCE hResource,
    _In_opt_ LPCWSTR   lpszDeviceName,
    _In_     DWORD     dwMaxQuoLogSize
);

Parameters

hResource [in]

Handle to the new quorum resource; or the existing quorum resource when dwMaxQuoLogSize is CLUS_NODE_MAJORITY_QUORUM.

lpszDeviceName [in, optional]

Determines the drive letter and path that the Cluster service will use to maintain the quorum files on the new quorum resource. Pass a null-terminated Unicode string or NULL, as follows.

  • If you specify a drive letter in the path, the Cluster service will verify that the drive letter refers to a valid partition on the new quorum resource.
  • If you do not specify a drive letter in the path, the Cluster service will use a default partition on the new quorum resource (see below).
  • If NULL, the Cluster service will use a default partition and a default path name (see below).

The Cluster service uses the partition flagged as CLUSPROP_PIFLAG_DEFAULT_QUORUM as the default partition (see CLUSPROP_PARTITION_INFO), or, if the flag cannot be found, the first available NTFS partition on the new quorum resource.

For the default path name, the Cluster service uses the previous path name if one exists; otherwise it uses "MSCS".

dwMaxQuoLogSize [in]

The quorum type value. Specify one of the three constants listed. When you specify CLUS_NODE_MAJORITY_QUORUM, hResource must refer to the existing quorum resource.

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

Return value

If the operation succeeds, the function returns ERROR_SUCCESS (0).

If the operation fails, the function returns a system error code. The following is a possible error code.

ERROR_RESOURCE_NOT_ONLINE

5004 (0x138C)

The quorum resource is not online.

Remarks

Do not call SetClusterQuorumResource from a resource DLL. For more information, see Function Calls to Avoid in Resource DLLs.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Enterprise, Windows Server 2008 Datacenter

Header

ClusAPI.h

Library

ClusAPI.lib

DLL

ClusAPI.dll

See also

GetClusterQuorumResource

 

 

Show: