OpenClusterNetInterfaceEx-Funktion (clusapi.h)
Ö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 |