GetClusterNetInterface-Funktion (clusapi.h)

Artikel
02/26/2024

Gibt den Namen der Schnittstelle eines Knotens an ein Netzwerk in einem Cluster zurück. Der PCLUSAPI_GET_CLUSTER_NET_INTERFACE Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD GetClusterNetInterface(
  [in]      HCLUSTER hCluster,
  [in]      LPCWSTR  lpszNodeName,
  [in]      LPCWSTR  lpszNetworkName,
  [out]     LPWSTR   lpszInterfaceName,
  [in, out] LPDWORD  lpcchInterfaceName
);

Parameter

[in] hCluster

Handle mit einem Cluster.

[in] lpszNodeName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Knotens im Cluster enthält.

[in] lpszNetworkName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Netzwerks enthält.

[out] lpszInterfaceName

Zeiger auf einen Ausgabepuffer mit dem Namen der Netzwerkschnittstelle.

[in, out] lpcchInterfaceName

Zeiger auf die Größe des Puffers lpszInterfaceName als Anzahl von Zeichen. Geben Sie bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich des beendenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der beendende 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 lpszInterfaceName verweist, ist nicht groß genug, um das Ergebnis zu halten. Der lpcchInterfaceName-Parameter gibt die Anzahl der Zeichen im Ergebnis zurück, wobei das beendende NULL ausgeschlossen wird.

Hinweise

Beachten Sie, dass lpcchInterfaceName auf eine Anzahl von Zeichen und nicht auf die Anzahl von Bytes verweist, und dass die zurückgegebene Größe nicht den beendenden NULL 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

OpenCluster

Freigeben über