Función OpenClusterGroupEx (clusapi.h)

  • Artículo

Abre un grupo de clústeres de conmutación por error y devuelve un identificador.

Sintaxis

HGROUP OpenClusterGroupEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszGroupName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parámetros

[in] hCluster

Identificador de un clúster que incluye el grupo que se va a abrir.

[in, optional] lpszGroupName

Nombre del grupo que se va a abrir.

[in] dwDesiredAccess

Privilegios de acceso solicitados. Puede tratarse de cualquier combinación de GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) o MAXIMUM_ALLOWED (0x02000000). Si este valor es cero (0) y se puede devolver un error indefinido. El uso de GENERIC_ALL es el mismo que llamar a OpenClusterGroup.

[out, optional] lpdwGrantedAccess

Parámetro opcional que contiene la dirección de un DWORD que recibirá los derechos de acceso concedidos. Si el parámetro DesiredAccess es MAXIMUM_ALLOWED (0x02000000), el DWORD al que apunta este parámetro contendrá los privilegios máximos concedidos a este usuario.

Valor devuelto

Si la operación se realizó correctamente, OpenClusterGroupEx devuelve un identificador de grupo.

Código devuelto Descripción
NULL
 La operación no se realizó correctamente. Para obtener más información sobre el error, llame a la función GetLastError . Si el servidor de destino no admite la función OpenClusterGroupEx (por ejemplo, si el servidor de destino ejecuta Windows Server 2008 o versiones anteriores), la función GetLastError devolverá RPC_S_PROCNUM_OUT_OF_RANGE (1745).

Requisitos

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

Consulte también

CloseClusterGroup

Funciones de administración de grupos

OpenClusterGroup