OpenCluster-Funktion (clusapi.h)

  • Artikel

Öffnet eine Verbindung mit einem Cluster und gibt ein Handle zurück.

Syntax

HCLUSTER OpenCluster(
  [in, optional] LPCWSTR lpszClusterName
);

Parameter

[in, optional] lpszClusterName

Gibt einen der folgenden Werte an:

  • Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Clusters oder einen der Clusterknoten enthält, die als NetBIOS-Name, einen vollqualifizierten DNS-Namen oder eine IP-Adresse ausgedrückt werden. Dadurch wird ein RPC-Clusterhandle erzeugt.
  • NULL, das ein LPC-Handle für den Cluster erzeugt, zu dem der lokale Computer gehört.

Rückgabewert

Wenn der Vorgang erfolgreich war, gibt OpenCluster ein Clusterhandle zurück.

Rückgabecode/-wert BESCHREIBUNG
NULL
0
 Der Vorgang war nicht erfolgreich. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

Ein Clusterhandle ist ein Zeiger auf eine intern definierte Struktur, die Informationen zur RPC- oder LPC-Verbindung mit dem Cluster speichert. Alle aus dem Clusterhandle abgerufenen Objekthandles werden den in der Clusterstruktur gespeicherten RPC- oder LPC-Sitzungsdaten zugeordnet. Das Kombinieren von RPC- und LPC-Handles oder die Verwendung von Handles, die aus verschiedenen Kontexten abgerufen wurden, kann Ausnahmen oder andere unvorhersehbare Ergebnisse verursachen. Weitere Informationen finden Sie unter LPC- und RPC-Handles.

Wenn Sie mit einem Clusterhandle fertig sind, ist es wichtig , CloseCluster aufzurufen, um sicherzustellen, dass der gesamte Arbeitsspeicher freigegeben und die Verbindung ordnungsgemäß heruntergefahren wird.

Wenn der Cluster remote ist, muss auf dem Client ein kompatibles Betriebssystem ausgeführt werden. Beispielsweise können Computer, auf denen Windows Server 2008 ausgeführt wird, OpenCluster nicht für einen Cluster aufrufen, auf dem Windows Server 2016 ausgeführt wird. Um diese Cluster remote zu verwalten, verwenden Sie den Failovercluster-WMI-Anbieter.

Beispiele

Weitere Informationen finden Sie unter Verwenden von Objekthandles.

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

CloseCluster

Failoverclusterverwaltungsfunktionen

OpenClusterEx