Función OpenClusterNetInterfaceEx (clusapi.h)
Abre un identificador para una interfaz de red.
Sintaxis
HNETINTERFACE OpenClusterNetInterfaceEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszInterfaceName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Parámetros
[in] hCluster
Identificador de un clúster.
[in, optional] lpszInterfaceName
Puntero a una cadena Unicode terminada en null que contiene el nombre de la interfaz de red que se va a abrir.
[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 OpenClusterNetInterface.
[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, OpenClusterNetInterfaceEx devuelve un identificador abierto a la interfaz de red especificada.
| 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 OpenClusterNetInterfaceEx (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 |