SetClusterQuorumResource-Funktion (clusapi.h)

Artikel
02/24/2024

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

Freigeben über