Función OpenClusterNodeEx (clusapi.h)
Abre un nodo y devuelve un identificador.
Sintaxis
HNODE OpenClusterNodeEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNodeName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Parámetros
[in] hCluster
Identificador de un clúster devuelto desde las funciones OpenCluster o OpenClusterEx .
[in, optional] lpszNodeName
Puntero al nombre NetBIOS de un nodo existente. Si se usa el nombre DNS del nodo, se producirá un error en la función OpenClusterNodeEx y GetLastError devolverá ERROR_CLUSTER_NODE_NOT_FOUND.
[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 OpenClusterNode.
[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, OpenClusterNodeEx devuelve un identificador de nodo.
| 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 OpenClusterNodeEx (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 |