OpenCluster-Funktion (clusapi.h)
Ö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 |
|---|---|
|
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 |