OpenClusterGroupEx-Funktion (clusapi.h)

Artikel
02/26/2024

Öffnet eine Failoverclustergruppe und gibt ein Handle zurück.

Syntax

HGROUP OpenClusterGroupEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszGroupName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parameter

[in] hCluster

Behandeln Sie einen Cluster, der die zu öffnende Gruppe enthält.

[in, optional] lpszGroupName

Name der zu öffnenden Gruppe.

[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 OpenClusterGroup.

[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 OpenClusterGroupEx ein Gruppenhandle 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 OpenClusterGroupEx-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

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

Weitere Informationen

CloseClusterGroup

Gruppenverwaltungsfunktionen

OpenClusterGroup

Freigeben über