GetClusterFromNetInterface-Funktion (clusapi.h)
Gibt ein Handle an den Cluster zurück, der einer Netzwerkschnittstelle zugeordnet ist. Der PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE Typ definiert einen Zeiger auf diese Funktion.
Syntax
HCLUSTER GetClusterFromNetInterface(
[in] HNETINTERFACE hNetInterface
);
Parameter
[in] hNetInterface
Handle für die Netzwerkschnittstelle.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Handle an den Cluster zurück, der besitzer der Netzwerkschnittstelle ist.
Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Rufen Sie GetLastError auf, um weitere Informationen zum Fehler zu erhalten.
Hinweise
Damit hNetInterface ein gültiges Handle ist, muss unbedingt ein offenes Clusterhandle vorhanden sein (siehe OpenClusterNetInterface). GetClusterFromNetInterface gibt eine weitere instance des Handles zurück, aus dem hNetInterface abgerufen wurde.
Achten Sie darauf , CloseCluster für das von GetClusterFromNetInterface zurückgegebene Handle aufzurufen, bevor das Handle den Gültigkeitsbereich überschreitet. Durch das Schließen dieses Handles wird hNetInterface oder das Clusterhandle, aus dem hNetInterface abgerufen wurde, nicht ungültig.
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 |