Freigeben über


GetClusterNetInterfaceState-Funktion (clusapi.h)

Gibt den aktuellen Zustand einer Netzwerkschnittstelle zurück. Der PCLUSAPI_GET_CLUSTER_NET_INTERFACE_STATE Typ definiert einen Zeiger auf diese Funktion.

Syntax

CLUSTER_NETINTERFACE_STATE GetClusterNetInterfaceState(
  [in] HNETINTERFACE hNetInterface
);

Parameter

[in] hNetInterface

Handle an die Netzwerkschnittstelle, für die Zustandsinformationen zurückgegeben werden sollen.

Rückgabewert

GetClusterNetInterfaceState gibt den aktuellen Zustand der Netzwerkschnittstelle zurück, der durch einen der folgenden Werte dargestellt wird, die von der CLUSTER_NETINTERFACE_STATE-Enumeration aufgezählt werden.

Rückgabecode/-wert BESCHREIBUNG
ClusterNetInterfaceFailed
1
Die Netzwerkschnittstelle kann nicht mit einer anderen Netzwerkschnittstelle kommunizieren.
ClusterNetInterfaceUnreachable
2
Die Netzwerkschnittstelle kann nicht mit mindestens einer anderen Netzwerkschnittstelle kommunizieren, deren Status nicht ClusterNetInterfaceFailed oder ClusterNetInterfaceUnavailable ist.
ClusterNetInterfaceUp
3
Die Netzwerkschnittstelle kann mit allen anderen Netzwerkschnittstellen kommunizieren, deren Status nicht ClusterNetInterfaceFailed oder ClusterNetInterfaceUnavailable ist.
ClusterNetInterfaceUnavailable
0
Der Knoten, der die Netzwerkschnittstelle besitzt, ist ausgefallen.
ClusterNetInterfaceStateUnknown
-1
Der Vorgang war nicht erfolgreich. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Anforderungen

   
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

CLUSTER_NETINTERFACE_STATE

OpenClusterNetInterface

State-Eigenschaft des ClusNetInterface-Objekts