GetClusterNodeId-Funktion (clusapi.h)
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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 |