Freigeben über

GetClusterNodeId-Funktion (clusapi.h)

  • Artikel

Gibt den eindeutigen Bezeichner eines Clusterknotens zurück. Der PCLUSAPI_GET_CLUSTER_NODE_ID Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD GetClusterNodeId(
  [in, optional] HNODE   hNode,
  [out]          LPWSTR  lpszNodeId,
  [in, out]      LPDWORD lpcchName
);

Parameter

[in, optional] hNode

Handle für den Knoten mit dem zurückzugebenden Bezeichner oder NULL. Wenn hNode auf NULL festgelegt ist, wird der Knotenbezeichner für den Knoten, auf dem die Anwendung ausgeführt wird, im Inhalt von lpszNodeId zurückgegeben.

[out] lpszNodeId

Dieser Parameter verweist auf einen Puffer, der die eindeutige ID von hNode empfängt, einschließlich des beendenden NULL-Zeichens.

[in, out] lpcchName

Zeigen Sie bei der Eingabe auf die Anzahl der Zeichen im Puffer, auf die der Parameter lpszNodeId verweist, einschließlich des NULL-Abschlusszeichens . Zeigen Sie bei der Ausgabe auf die Anzahl der im Puffer gespeicherten Zeichen mit Ausnahme des NULL-Abschlusszeichens .

Rückgabewert

Diese Funktion gibt einen Systemfehlercode zurück. Folgende Werte sind möglich:

Rückgabecode/-wert BESCHREIBUNG
ERROR_SUCCESS
0
 Der Vorgang wurde erfolgreich abgeschlossen.
ERROR_MORE_DATA
234 (0xEA)
 Weitere Daten sind verfügbar. Dieser Wert wird zurückgegeben, wenn der Puffer, auf den lpszNodeId verweist, nicht lang genug ist, um die erforderliche Anzahl von Zeichen zu enthalten. GetClusterNodeId legt den Inhalt von lpcchName auf die erforderliche Länge fest.

Hinweise

Der PCLUSAPI_GET_CLUSTER_NODE_ID Typ definiert einen Zeiger auf diese Funktion.

Wenn hNode auf NULL festgelegt ist und der Aufrufer auf einem aktiven Clusterknoten ausgeführt wird, gibt die GetClusterNodeId-Funktion den Bezeichner des Knotens zurück, auf dem die Anwendung ausgeführt wird. Das Festlegen von hNode auf NULL ist eine praktische Möglichkeit für Ressourcen-DLLs , um den Knotenbezeichner des Knotens zu bestimmen, auf dem sie ausgeführt werden. Das Makro GetCurrentClusterNodeId kann verwendet werden, anstatt NULL für den hNode-Parameter zu übergeben.

Ein Clusterknotenbezeichner ist ein eindeutiger Bezeichner, der sich auch dann nicht ändert, wenn der Name des Knotens geändert wird.

Beachten Sie, dass lpcchName auf eine Anzahl von Zeichen und nicht auf die Anzahl von Bytes bezieht, und dass die zurückgegebene Größe nicht den abschließenden NULL-Wert in der Anzahl enthält. Weitere Informationen zur Größenanpassung von Puffern finden Sie unter Datengrößenkonventionen.

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

GetCurrentClusterNodeId

Knotenverwaltungsfunktionen

OpenClusterNode