Compartir a través de


Función MprAdminInterfaceConnect (mprapi.h)

La función MprAdminInterfaceConnect crea una conexión a la interfaz WAN especificada.

Sintaxis

DWORD MprAdminInterfaceConnect(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] HANDLE            hEvent,
  [in] BOOL              fSynchronous
);

Parámetros

[in] hMprServer

Controle al enrutador en el que se va a ejecutar esta llamada. Obtenga este identificador llamando a MprAdminServerConnect.

[in] hInterface

Identificador de la interfaz. Este identificador se obtiene de una llamada anterior a MprAdminInterfaceCreate.

[in] hEvent

Controle un evento que se señale después de que se haya completado el intento de conectar la interfaz. La función inicia el intento de conexión y devuelve inmediatamente. Una vez señalado el evento, puede obtener el resultado del intento de conexión llamando a MprAdminInterfaceGetInfo.

Si este parámetro es NULL y fBlocking es TRUE, esta llamada es sincrónica, es decir, la función no devuelve hasta que se haya completado el intento de conexión.

La aplicación que llama debe especificar NULL para este parámetro, si hMprServer especifica un enrutador remoto.

[in] fSynchronous

Si hEvent es NULL y este parámetro se establece en TRUE, la función no devuelve hasta que se haya completado el intento de conexión.

Si hEvent es NULL y este parámetro se establece en FALSE, la función devolverá inmediatamente. Un valor devuelto de PENDING indica que el intento de conexión se inició correctamente.

Si hEvent no es NULL, este parámetro se omite.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_ACCESS_DENIED
La aplicación que realiza la llamada no tiene privilegios suficientes.
ERROR_ALREADY_CONNECTING
Ya hay una conexión en curso en esta interfaz.
ERROR_DDM_NOT_RUNNING
El Administrador de marcado a petición (DDM) no se está ejecutando.
ERROR_INTERFACE_DISABLED
La interfaz está deshabilitada actualmente.
ERROR_INTERFACE_HAS_NO_DEVICES
No hay adaptadores disponibles para esta interfaz.
ERROR_INVALID_HANDLE
El valor hInterface no es válido.
ERROR_SERVICE_IS_PAUSED
El servicio de marcado a petición está actualmente en pausa.
PENDIENTE
La interfaz está en proceso de conexión. La aplicación que realiza la llamada debe esperar en el identificador hEvent , si se especificó uno. Una vez señalado el evento, puede obtener el estado de la conexión y cualquier error asociado llamando a MprAdminInterfaceGetInfo.
 
 

Comentarios

En la tabla siguiente se resume la relación entre hEvent y fBlocking.

hEvent fBlocking Resultado
Identificador de eventos Omitido La llamada se devuelve inmediatamente. Un valor devuelto de PENDING indica que el intento se inició correctamente. Espere en hEvent. Cuando se señale hEvent , use MprAdminInterfaceGetInfo para determinar el éxito o error del intento de conexión.
NULL TRUE La llamada no se devuelve hasta que se haya completado el intento de conexión.
NULL FALSE La llamada se devuelve inmediatamente. Un valor devuelto de PENDING indica que el intento se inició correctamente.
 
 

Requisitos

   
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mprapi.h
Library Mprapi.lib
Archivo DLL Mprapi.dll

Consulte también

MprAdminInterfaceCreate

MprAdminInterfaceDisconnect

MprAdminInterfaceGetInfo

MprAdminServerConnect

Funciones de administración del enrutador

Referencia de administración de enrutadores