OpenClusterEx-Funktion (clusapi.h)

Artikel
02/26/2024

Öffnet eine Verbindung mit einem Cluster und gibt ein Handle zurück.

Syntax

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

Parameter

[in, optional] lpszClusterName

Gibt einen der folgenden Werte an:

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Clusters oder einen der Clusterknoten enthält, der als NetBIOS-Name, vollqualifizierter DNS-Name oder IP-Adresse ausgedrückt wird. Dadurch wird ein RPC-Clusterhandle erzeugt.
NULL, wodurch ein LPC-Handle für den Cluster erzeugt wird, zu dem der lokale Computer gehört.

[in] DesiredAccess

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 von GENERIC_ALL entspricht dem Aufrufen von OpenCluster.

[out, optional] GrantedAccess

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 OpenClusterEx ein Clusterhandle zurück.

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

Hinweise

Ein Clusterhandle ist ein Zeiger auf eine intern definierte Struktur, die Informationen über die RPC- oder LPC-Verbindung mit dem Cluster speichert. Alle aus dem Clusterhandle abgerufenen Objekthandles werden den in der Clusterstruktur gespeicherten RPC- oder LPC-Sitzungsdaten zugeordnet. Das Kombinieren von RPC- und LPC-Handles oder die Verwendung von Handles, die aus verschiedenen Kontexten abgerufen wurden, kann zu Ausnahmen oder anderen unvorhersehbaren Ergebnissen führen. Weitere Informationen finden Sie unter LPC- und RPC-Handles.

Wenn Sie mit einem Clusterhandle fertig sind, ist es wichtig, CloseCluster aufzurufen, um sicherzustellen, dass der gesamte Arbeitsspeicher freigegeben und die Verbindung ordnungsgemäß heruntergefahren wird.

Anforderungen

Anforderung	Wert
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

Freigeben über