ClusterGroupSetControl-Funktion (clusapi.h)

Artikel
08/22/2023

Initiiert einen Vorgang, der sich auf ein Gruppenset auswirkt.

Der ausgeführte Vorgang hängt vom Steuerelementcode ab, der an den dwControlCode-Parameter übergeben wird.

Syntax

DWORD ClusterGroupSetControl(
  [in]            HGROUPSET hGroupSet,
  [in, optional]  HNODE     hHostNode,
  [in]            DWORD     dwControlCode,
  [in, optional]  LPVOID    lpInBuffer,
  [in]            DWORD     cbInBufferSize,
  [out, optional] LPVOID    lpOutBuffer,
  [in]            DWORD     cbOutBufferSize,
  [out, optional] LPDWORD   lpBytesReturned
);

Parameter

[in] hGroupSet

Behandeln Sie das zu betroffene Gruppenset.

[in, optional] hHostNode

Wenn nicht NULL, behandeln Sie den Knoten, um den vorgang auszuführen, der durch den Steuerelementcode dargestellt wird. Bei NULL führt der Knoten , der das Gruppenset besitzt, den Vorgang aus. Die Angabe von hHostNode ist optional.

[in] dwControlCode

Ein Sammlungssteuerungscode , der den auszuführenden Vorgang angibt. Informationen zur Syntax, die einem Steuerelementcode zugeordnet ist, finden Sie unter
Steuerungscodearchitektur und die folgenden Themen:

[in, optional] lpInBuffer

Zeiger auf einen Eingabepuffer, der informationen enthält, die für den Vorgang benötigt werden, oder NULL , wenn keine Informationen benötigt werden.

[in] cbInBufferSize

Die zugeordnete Größe (in Bytes) des Eingabepuffers.

[out, optional] lpOutBuffer

Zeiger auf einen Ausgabepuffer, um die aus dem Vorgang resultierenden Daten zu empfangen, oder NULL , wenn keine Daten zurückgegeben werden.

[in] cbOutBufferSize

Die zugeordnete Größe (in Bytes) des Ausgabepuffers.

[out, optional] lpBytesReturned

Gibt die tatsächliche Größe (in Bytes) der Daten zurück, die sich aus dem Vorgang ergeben. Wenn diese Informationen nicht benötigt werden, übergeben Sie NULL für lpBytesReturned.

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Der Vorgang wurde durchgeführt. Wenn für den Vorgang ein Ausgabepuffer erforderlich ist, verweist lpBytesReturned (wenn nicht null bei der Eingabe) auf die tatsächliche Größe der im Puffer zurückgegebenen Daten.
ERROR_MORE_DATA	Der Ausgabepuffer, auf den lpOutBuffer verweist, war nicht groß genug, um die aus dem Vorgang resultierenden Daten aufzunehmen. Der parameter lpBytesReturned (wenn nicht NULL bei der Eingabe) verweist auf die größe, die für den Ausgabepuffer erforderlich ist. Nur Vorgänge, die einen Ausgabepuffer erfordern , geben ERROR_MORE_DATA zurück. Wenn der lpOutBuffer-ParameterNULL und der nOutBufferSize-Parameter null ist, werden möglicherweise ERROR_SUCCESS zurückgegeben, nicht ERROR_MORE_DATA.
Systemfehlercode	Der Vorgang war nicht erfolgreich. Wenn für den Vorgang ein Ausgabepuffer erforderlich ist, ist der von lpBytesReturned angegebene Wert (wenn nicht NULL bei der Eingabe) unzuverlässig.

Anforderungen

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

Freigeben über