GetClusterNetworkId-Funktion (clusapi.h)
Gibt den Bezeichner eines Netzwerks zurück. Der PCLUSAPI_GET_CLUSTER_NETWORK_ID Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD GetClusterNetworkId(
[in] HNETWORK hNetwork,
[out] LPWSTR lpszNetworkId,
[in, out] LPDWORD lpcchName
);
Parameter
[in] hNetwork
Handle für ein Netzwerk.
[out] lpszNetworkId
Zeiger auf den Bezeichner des Netzwerks, das hNetwork zugeordnet ist, einschließlich des NULL-Endzeichens.
[in, out] lpcchName
Zeiger auf die Größe des lpszNetworkID-Puffers als Anzahl von Zeichen. Geben Sie bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich der endenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der abschließende NULL-Wert ausgeschlossen wird.
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 einer der möglichen Werte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Puffer, auf den lpszNetworkID verweist, ist nicht groß genug, um das Ergebnis zu halten. Der lpcchNetworkID-Parameter gibt die Anzahl der Zeichen im Ergebnis zurück, wobei der beendende NULL-Wert ausgeschlossen wird. |
Hinweise
Beachten Sie, dass lpcchNetworkID 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 |