Función ClusterGroupSetControl (clusapi.h)

Inicia una operación que afecta a un conjunto de grupos.

La operación realizada depende del código de control pasado al parámetro dwControlCode .

Sintaxis

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

Parámetros

[in] hGroupSet

Controle el conjunto de grupos que se va a ver afectado.

[in, optional] hHostNode

Si no es NULL, controle al nodo para realizar la operación representada por el código de control. Si es NULL, el nodo que posee el conjunto de grupos realiza la operación. Especificar hHostNode es opcional.

[in] dwControlCode

Código de control de colección que especifica la operación que se va a realizar. Para ver la sintaxis asociada a un código de control, consulte
Controlar la arquitectura de código y los temas siguientes.

• CLUSCTL_GROUPSET_GET_COMMON_PROPERTIES
• CLUSCTL_GROUPSET_GET_GROUPS
• CLUSCTL_GROUPSET_GET_PROVIDER_GROUPS
• CLUSCTL_GROUPSET_GET_PROVIDER_COLLECTIONS
• CLUSCTL_GROUPSET_GET_RO_COMMON_PROPERTIES
• CLUSCTL_GROUPSET_SET_COMMON_PROPERTIES
• CLUSCTL_GROUP_GET_PROVIDER_GROUPS
• CLUSCTL_GROUP_GET_PROVIDER_COLLECTIONS

[in, optional] lpInBuffer

Puntero a un búfer de entrada que contiene información necesaria para la operación o NULL si no se necesita información.

[in] cbInBufferSize

Tamaño asignado (en bytes) del búfer de entrada.

[out, optional] lpOutBuffer

Puntero a un búfer de salida para recibir los datos resultantes de la operación o NULL si no se devolverán datos.

[in] cbOutBufferSize

Tamaño asignado (en bytes) del búfer de salida.

[out, optional] lpBytesReturned

Devuelve el tamaño real (en bytes) de los datos resultantes de la operación. Si esta información no es necesaria, pase NULL para lpBytesReturned.

Valor devuelto

La función devuelve uno de los valores siguientes.

Código devuelto	Descripción
ERROR_SUCCESS	La operación se realizó correctamente. Si la operación requería un búfer de salida, lpBytesReturned (si no es NULL en la entrada) apunta al tamaño real de los datos devueltos en el búfer.
ERROR_MORE_DATA	El búfer de salida al que apunta lpOutBuffer no era lo suficientemente grande como para contener los datos resultantes de la operación. El parámetro lpBytesReturned (si no es NULL en la entrada) apunta al tamaño necesario para el búfer de salida. Solo las operaciones que requieren un búfer de salida devuelven ERROR_MORE_DATA. Si el parámetro lpOutBuffer es NULL y el parámetro nOutBufferSize es cero, se puede devolver ERROR_SUCCESS, no ERROR_MORE_DATA.
Código de error del sistema	La operación no se realizó correctamente. Si la operación requiere un búfer de salida, el valor especificado por lpBytesReturned (si no es NULL en la entrada) no es confiable.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2016
Plataforma de destino	Windows
Encabezado	clusapi.h
Library	ClusAPI.lib
Archivo DLL	ClusAPI.dll