Freigeben über


SetClusterGroupNodeList-Funktion (clusapi.h)

Legt die bevorzugte Knotenliste für eine Gruppe fest. Der PCLUSAPI_SET_CLUSTER_GROUP_NODE_LIST-Typs definiert einen Zeiger auf diese Funktion.

Syntax

DWORD SetClusterGroupNodeList(
  [in] HGROUP   hGroup,
  [in] DWORD    NodeCount,
  [in] HNODE [] NodeList
);

Parameter

[in] hGroup

Handle für die Gruppe, der die Liste der Knoten zugewiesen werden soll.

[in] NodeCount

Anzahl der Knoten in der Liste, die durch NodeList identifiziert wird.

[in] NodeList

Array von Handles zu Knoten, in der Reihenfolge nach Vorliebe, wobei der erste Knoten der am meisten bevorzugte und der letzte Knoten der am wenigsten bevorzugte ist. Die Anzahl der Knoten im NodeList-Array wird durch den NodeCount-Parameter gesteuert.

Rückgabewert

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

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück.

Hinweise

Rufen Sie SetClusterGroupNodeList nicht über eine Ressourcen-DLL auf. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Übergeben Sie LPC- und RPC-Handles nicht an denselben Funktionsaufruf. Andernfalls löst der Aufruf eine RPC-Ausnahme aus und kann zusätzliche destruktive Auswirkungen haben. Informationen zum Erstellen von LPC- und RPC-Handles finden Sie unter Verwenden von Objekthandles und OpenCluster.

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

OpenCluster

OpenClusterGroup

OpenClusterNode