Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Öffnet ein Handle für eine Netzwerkschnittstelle.
Syntax
HNETINTERFACE OpenClusterNetInterfaceEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszInterfaceName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Parameter
[in] hCluster
Handle mit einem Cluster.
[in, optional] lpszInterfaceName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen der zu öffnenden Netzwerkschnittstelle enthält.
[in] dwDesiredAccess
Die angeforderten Zugriffsberechtigungen. Dies kann eine beliebige Kombination aus GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) oder MAXIMUM_ALLOWED (0x02000000) sein. Wenn dieser Wert null (0) ist und nicht definierte Fehler möglicherweise zurückgegeben werden. Die Verwendung GENERIC_ALL ist identisch mit dem Aufrufen von OpenClusterNetInterface.
[out, optional] lpdwGrantedAccess
Optionaler Parameter, der die Adresse eines DWORD-Werts enthält, der die gewährten Zugriffsrechte erhält. Wenn der DesiredAccess-ParameterMAXIMUM_ALLOWED (0x02000000) ist, enthält das DWORD , auf das dieser Parameter verweist, die maximalen Berechtigungen, die diesem Benutzer gewährt werden.
Rückgabewert
Wenn der Vorgang erfolgreich war, gibt OpenClusterNetInterfaceEx ein geöffnetes Handle an die angegebene Netzwerkschnittstelle zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang war nicht erfolgreich. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zum Fehler zu erhalten. Wenn der Zielserver die OpenClusterNetInterfaceEx-Funktion nicht unterstützt (z. B. wenn auf dem Zielserver Windows Server 2008 oder früher ausgeführt wird), gibt die GetLastError-FunktionRPC_S_PROCNUM_OUT_OF_RANGE (1745) zurück. |
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise |
| Zielplattform | Windows |
| Kopfzeile | clusapi.h |
| Bibliothek | ClusAPI.lib |
| DLL | ClusAPI.dll |