Freigeben über

GetClusterNetworkId-Funktion (clusapi.h)

  • Artikel

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
ERROR_MORE_DATA
 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

Weitere Informationen

OpenClusterNetwork