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 |
|---|---|
|
Ein geeigneter Hostknoten war nicht verfügbar. |
|
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 |