OnlineClusterResourceEx-Funktion (clusapi.h)

Artikel
08/22/2023

Schaltet eine Offline- oder ausgefallene Ressource online.

Syntax

DWORD OnlineClusterResourceEx(
  [in]           HRESOURCE hResource,
  [in]           DWORD     dwOnlineFlags,
  [in, optional] PBYTE     lpInBuffer,
  [in]           DWORD     cbInBufferSize
);

Parameter

[in] hResource

Das Handle für die Ressource, die online geschaltet werden 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_RESOURCE_ONLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000002)

Aktualisieren Sie den persistenten Zustand der Ressource nicht.

CLUSAPI_RESOURCE_ONLINE_NECESSARY_FOR_QUORUM (0x00000004)

Die Ressource muss online geschaltet werden, um ein Quorum aufrechtzuerhalten.

CLUSAPI_RESOURCE_ONLINE_BEST_POSSIBLE_NODE (0x00000008)

Der Clusterdienst bestimmt den Knoten, auf dem die Ressource gehostet wird, wenn sie online geschaltet wird.

Windows Server 2012 R2 und Windows Server 2012: Dieser Wert wird vor Windows Server 2016 nicht unterstützt.

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 von lpInBuffer 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 ist ein möglicher Fehlercode aufgeführt.

Rückgabecode	Beschreibung
ERROR_IO_PENDING	Die Ressource oder eine der Ressourcen, von denen sie abhängt, hat ERROR_IO_PENDING von ihrer Online-Einstiegspunktfunktion zurückgegeben.

Anforderungen

Anforderung	Wert
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

Failoverclusterressourcenverwaltungsfunktionen

Freigeben über