Función OpenClusterResourceEx (clusapi.h)

Abre un recurso y devuelve un identificador.

Sintaxis

HRESOURCE OpenClusterResourceEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszResourceName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parámetros

[in] hCluster

Identificador de un clúster.

[in, optional] lpszResourceName

Puntero a una cadena Unicode terminada en null que contiene el nombre del recurso que se va a abrir.

Los nombres de recursos no distinguen mayúsculas de minúsculas. Un nombre de recurso debe ser único dentro del clúster. El nombre se establece cuando se crea el recurso y se puede cambiar mediante la función SetClusterResourceName .

[in] dwDesiredAccess

Privilegios de acceso solicitados. Puede ser 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 OpenClusterResource.

[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, OpenClusterResourceEx devuelve un identificador al recurso abierto.

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 OpenClusterResourceEx (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

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

CloseClusterResource

Funciones de administración de recursos de clúster de conmutación por error

OpenClusterResource