OnlineClusterGroupEx-Funktion (clusapi.h)

Schaltet eine Gruppe online.

Syntax

DWORD OnlineClusterGroupEx(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode,
  [in]           DWORD  dwOnlineFlags,
  [in, optional] PBYTE  lpInBuffer,
  [in]           DWORD  cbInBufferSize
);

Parameter

[in] hGroup

Ein Handle für die Gruppe, die online geschaltet werden soll.

[in, optional] hDestinationNode

Ein Handle für den Knoten , der die Gruppe hosten soll.

[in] dwOnlineFlags

Ein Flag, das Einstellungen für die Ressource angibt, die online geschaltet werden soll.

CLUSAPI_GROUP_ONLINE_IGNORE_RESOURCE_STATUS (0x00000001)

Der Server ignoriert den gesperrten Modus für die Ressource.

CLUSAPI_GROUP_ONLINE_SYNCHRONOUS (0x00000002)

Verwenden Sie einen synchronen Vorgang, um die Gruppe online zu schalten.

Windows Server 2012 R2 und Windows Server 2012: Dieser Wert wurde in Windows Server 2016 hinzugefügt.

CLUSAPI_GROUP_ONLINE_BEST_POSSIBLE_NODE (0x00000004)

Der Clusterdienst bestimmt den Knoten, der die Gruppe hosten soll, wenn sie online geschaltet wird.

Windows Server 2012 R2 und Windows Server 2012: Dieser Wert wurde in Windows Server 2016 hinzugefügt.

0

Der Server darf den gesperrten Modus für die Ressource nicht ignorieren.

[in, optional] lpInBuffer

Ein Zeiger auf den Eingabepuffer, der Anweisungen für den Vorgang empfängt. Der lpInBuffer-Parameter ist als Eigenschaftenliste formatiert.

[in] cbInBufferSize

Die Größe des lpInBuffer-Parameters in Bytes.

Rückgabewert

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

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden finden Sie mögliche Fehlercodes.

Rückgabecode	Beschreibung
ERROR_HOST_NODE_NOT_AVAILABLE	Ein geeigneter Hostknoten war nicht verfügbar.
ERROR_IO_PENDING	Der Vorgang wird ausgeführt.

Anforderungen

Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

Gruppenverwaltungsfunktionen