SetClusterQuorumResource-Funktion (clusapi.h)

Erstellt eine Ressource als Quorumressource für einen Cluster. Der PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE-Typs definiert einen Zeiger auf diese Funktion.

Syntax

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

Parameter

[in] hResource

Behandeln der neuen Quorumressource; oder die vorhandene Quorumressource , wenn dwMaxQuoLogSizeCLUS_NODE_MAJORITY_QUORUM ist.

[in, optional] lpszDeviceName

Bestimmt den Laufwerkbuchstaben und pfad, den der Clusterdienst verwendet, um die Quorumdateien für die neue Quorumressource zu verwalten. Übergeben Sie wie folgt eine Unicode-Zeichenfolge mit NULL-Beendigung oder NULL.

• Wenn Sie einen Laufwerkbuchstaben im Pfad angeben, überprüft der Clusterdienst, ob der Laufwerkbuchstabe auf eine gültige Partition der neuen Quorumressource verweist.
• Wenn Sie keinen Laufwerkbuchstaben im Pfad angeben, verwendet der Clusterdienst eine Standardpartition für die neue Quorumressource (siehe unten).
• Bei NULL verwendet der Clusterdienst eine Standardpartition und einen Standardpfadnamen (siehe unten).

Der Clusterdienst verwendet die Partition, die als CLUSPROP_PIFLAG_DEFAULT_QUORUM als Standardpartition gekennzeichnet ist (siehe CLUSPROP_PARTITION_INFO), oder, wenn das Flag nicht gefunden werden kann, die erste verfügbare NTFS-Partition in der neuen Quorumressource.

Für den Standardpfadnamen verwendet der Clusterdienst den vorherigen Pfadnamen, sofern vorhanden; andernfalls wird "MSCS" verwendet.

[in] dwMaxQuoLogSize

Der Quorumtypwert. Geben Sie eine der drei aufgeführten Konstanten an. Wenn Sie CLUS_NODE_MAJORITY_QUORUM angeben, muss hResource auf die vorhandene Quorumressource verweisen.

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS (0) zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden ist ein möglicher Fehlercode aufgeführt.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_RESOURCE_NOT_ONLINE 5004 (0x138C)	Die Quorumressource ist nicht online.

Hinweise

Rufen Sie SetClusterQuorumResource nicht über eine Ressourcen-DLL auf. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

GetClusterQuorumResource