ClusterNetworkOpenEnum-Funktion (clusapi.h)
Öffnet einen Enumerator zum Durchlaufen von Objekten in einem Netzwerk. Der PCLUSAPI_CLUSTER_NETWORK_OPEN_ENUM Typ definiert einen Zeiger auf diese Funktion.
Syntax
HNETWORKENUM ClusterNetworkOpenEnum(
[in] HNETWORK hNetwork,
[in] DWORD dwType
);
Parameter
[in] hNetwork
Ein Handle für ein Netzwerk.
[in] dwType
Eine Bitmaske, die den Typ der aufzuzählenden Objekte beschreibt. Mindestens einer der folgenden Werte CLUSTER_NETWORK_ENUM Enumeration ist gültig.
CLUSTER_NETWORK_ENUM_NETINTERFACES (1)
Listet die Netzwerkschnittstellenobjekte im Netzwerk auf.
Rückgabewert
Wenn der Vorgang erfolgreich war, gibt ClusterNetworkOpenEnum ein Handle an einen Netzwerkenumerator zurück.
Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.
Hinweise
Anwendungen rufen die ClusterNetworkOpenEnum-Funktion auf, um einen bestimmten Enumeratortyp zu erstellen. ClusterNetworkOpenEnum kann Enumeratoren zum Durchlaufen aller Objekte in einem Netzwerk oder nur der Netzwerkschnittstellenobjekte erstellen. ClusterNetworkOpenEnum gibt ein Handle zurück, das an ClusterNetworkEnum übergeben werden kann, um auf jedes der zu enumerierten Objekte zuzugreifen, und an ClusterNetworkCloseEnum , um den Enumerator freizugeben.
Beispiele
Weitere Informationen finden Sie unter Auflisten von Objekten.
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 |