Partager via

Fonction ClusterGroupSetControl (clusapi.h)

  • Article

Lance une opération affectant un ensemble de groupes.

L’opération effectuée dépend du code de contrôle passé au paramètre dwControlCode .

Syntaxe

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
);

Paramètres

[in] hGroupSet

Gérez l’ensemble de groupes à affecter.

[in, optional] hHostNode

Si la valeur n’est pas NULL, gérez le nœud pour effectuer l’opération représentée par le code de contrôle. Si la valeur est NULL, le nœud propriétaire de l’ensemble de groupes effectue l’opération. La spécification de hHostNode est facultative.

[in] dwControlCode

Code de contrôle de collection spécifiant l’opération à effectuer. Pour connaître la syntaxe associée à un code de contrôle, reportez-vous à
Architecture du code de contrôle et les rubriques suivantes.

[in, optional] lpInBuffer

Pointeur vers une mémoire tampon d’entrée contenant les informations nécessaires à l’opération ou NULL si aucune information n’est nécessaire.

[in] cbInBufferSize

Taille allouée (en octets) de la mémoire tampon d’entrée.

[out, optional] lpOutBuffer

Pointeur vers une mémoire tampon de sortie pour recevoir les données résultant de l’opération, ou NULL si aucune donnée ne sera retournée.

[in] cbOutBufferSize

Taille allouée (en octets) de la mémoire tampon de sortie.

[out, optional] lpBytesReturned

Retourne la taille réelle (en octets) des données résultant de l’opération. Si ces informations ne sont pas nécessaires, passez la valeur NULL pour lpBytesReturned.

Valeur retournée

La fonction retourne l’une des valeurs suivantes.

Code de retour Description
ERROR_SUCCESS
 L'opération a réussi. Si l’opération nécessitait une mémoire tampon de sortie, lpBytesReturned (s’il n’est pas NULL en entrée) pointe vers la taille réelle des données retournées dans la mémoire tampon.
ERROR_MORE_DATA
 La mémoire tampon de sortie pointée par lpOutBuffer n’était pas assez grande pour contenir les données résultant de l’opération. Le paramètre lpBytesReturned (s’il n’est pas NULL en entrée) pointe vers la taille requise pour la mémoire tampon de sortie. Seules les opérations nécessitant une mémoire tampon de sortie retournent ERROR_MORE_DATA. Si le paramètre lpOutBuffer a la valeur NULL et que le paramètre nOutBufferSize a la valeur zéro, ERROR_SUCCESS peut être retourné, et non ERROR_MORE_DATA.
Code d’erreur système
 L’opération n’a pas réussi. Si l’opération nécessite une mémoire tampon de sortie, la valeur spécifiée par lpBytesReturned (si elle n’est pas NULL en entrée) n’est pas fiable.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête clusapi.h
Bibliothèque ClusAPI.lib
DLL ClusAPI.dll