Función MprAdminInterfaceConnect (mprapi.h)

Artículo
03/15/2023

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