OpenClusterNodeEx-Funktion (clusapi.h)

Artikel
08/22/2023

Öffnet einen Knoten und gibt ein Handle zurück.

Syntax

HNODE OpenClusterNodeEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszNodeName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parameter

[in] hCluster

Handle für einen Cluster , der von den OpenCluster - oder OpenClusterEx-Funktionen zurückgegeben wird.

[in, optional] lpszNodeName

Zeiger auf den NetBIOS-Namen eines vorhandenen Knotens. Wenn der DNS-Name des Knotens verwendet wird, schlägt die OpenClusterNodeEx-Funktion fehl, und GetLastError gibt ERROR_CLUSTER_NODE_NOT_FOUND zurück.

[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, wird möglicherweise ein undefinierter Fehler zurückgegeben. Die Verwendung GENERIC_ALL entspricht dem Aufrufen von OpenClusterNode.

[out, optional] lpdwGrantedAccess

Optionaler Parameter, der die Adresse eines DWORD enthält, das 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 OpenClusterNodeEx ein Knotenhandle zurück.

Rückgabecode	Beschreibung
NULL	Der Vorgang war nicht erfolgreich. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zum Fehler zu erhalten. Wenn der Zielserver die OpenClusterNodeEx-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

Weitere Informationen

CloseClusterNode

Knotenverwaltungsfunktionen

OpenCluster

OpenClusterEx

OpenClusterNode

Freigeben über