CreateClusterGroup-Funktion (clusapi.h)

Fügt einem Cluster eine Gruppe hinzu und gibt der neu hinzugefügten Gruppe ein Handle zurück. Der PCLUSAPI_CREATE_CLUSTER_GROUP Typ definiert einen Zeiger auf diese Funktion.

Syntax

HGROUP CreateClusterGroup(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszGroupName
);

Parameter

[in] hCluster

Handle an den Zielcluster.

[in] lpszGroupName

Zeiger auf eine Unicode-Zeichenfolge mit Null-Endung, die den Namen der Gruppe enthält, die dem durch hCluster identifizierten Cluster hinzugefügt werden soll. Wenn keine Gruppe mit diesem Namen vorhanden ist, erstellt CreateClusterGroup sie.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Gruppenhandle zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Rufen Sie GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

Rufen Sie CreateClusterGroup nicht aus einer Ressourcen-DLL auf. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Die CreateClusterGroup-Funktion ruft die CreateClusterGroupEx-Funktion mit einem NULL-CLUSTER_CREATE_GROUP_INFO auf. Die neue Gruppe wird mit dem Gruppentyp ClusGroupTypeUnknown erstellt.

Beispiele

Weitere Informationen finden Sie unter Erstellen von Gruppen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

OpenClusterGroup