Función GetClusterGroupState (clusapi.h)

Devuelve el estado actual de un grupo. El tipo PCLUSAPI_GET_CLUSTER_GROUP_STATE define un puntero a esta función.

Sintaxis

CLUSTER_GROUP_STATE GetClusterGroupState(
  [in]                HGROUP  hGroup,
  [out, optional]     LPWSTR  lpszNodeName,
  [in, out, optional] LPDWORD lpcchNodeName
);

Parámetros

[in] hGroup

Identificador del grupo para el que se debe devolver la información de estado.

[out, optional] lpszNodeName

Puntero a una cadena Unicode terminada en null que contiene el nombre del nodo que posee actualmente el grupo.

[in, out, optional] lpcchNodeName

Puntero al tamaño del búfer lpszNodeName como recuento de caracteres. En la entrada, especifique el número máximo de caracteres que puede contener el búfer, incluido el valor NULL de terminación. En la salida, especifica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.

Valor devuelto

GetClusterGroupState devuelve el estado actual del grupo, representado por uno de los valores siguientes.

Código o valor devuelto	Descripción
ClusterGroupStateUnknown -1	La operación no se realizó correctamente. Para obtener más información sobre el error, llame a la función GetLastError.
ClusterGroupOnline 0	Todos los recursos del grupo están en línea.
ClusterGroupOffline 1	Todos los recursos del grupo están sin conexión o no hay ningún recurso en el grupo.
ClusterGroupFailed 2	Error al menos un recurso del grupo (establezca un estado de ClusterResourceFailed desde la enumeración CLUSTER_RESOURCE_STATE ).
ClusterGroupPartialOnline 3	Al menos un recurso del grupo está en línea. No hay recursos pendientes o con errores.
ClusterGroupPending 4	Al menos un recurso del grupo está en estado pendiente. No hay recursos con errores.

Comentarios

Tenga en cuenta que lpcchName hace referencia a un recuento de caracteres y no a un recuento de bytes, y que el tamaño devuelto no incluye el valor NULL de terminación en el recuento. Para obtener más información sobre los búferes de tamaño, consulte Convenciones de tamaño de datos.

No llame a GetClusterGroupState desde ninguna función de punto de entrada dll de recurso. Se puede llamar a GetClusterGroupState de forma segura desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

Requisitos

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

Consulte también

CLUSTER_GROUP_STATE

CLUSTER_RESOURCE_STATE

Funciones de administración de grupos

OpenClusterGroup