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 |