Función OpenClusterNetworkEx (clusapi.h)
Abre una conexión a una red y devuelve un identificador a ella.
Sintaxis
HNETWORK OpenClusterNetworkEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNetworkName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Parámetros
[in] hCluster
Identificador de un clúster.
[in, optional] lpszNetworkName
Puntero al nombre de una red existente.
[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 OpenClusterNetwork.
[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, OpenClusterNetworkEx devuelve un identificador de red.
| Código devuelto | Descripción |
|---|---|
|
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 OpenClusterNetworkEx (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
Funciones de administración de redes de clústeres de conmutación por error