Función MprAdminInterfaceUpdateRoutes (mprapi.h)

La función MprAdminInterfaceUpdateRoutes solicita a un administrador de enrutadores especificado que actualice su información de enrutamiento para una interfaz especificada.

Sintaxis

DWORD MprAdminInterfaceUpdateRoutes(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwProtocolId,
  [in] HANDLE            hEvent
);

Parámetros

[in] hMprServer

Controle al enrutador en el que se está actualizando la información. Obtenga este identificador llamando a MprAdminServerConnect.

[in] hInterface

Identificador de la interfaz que se está actualizando. Obtenga este identificador llamando a MprAdminInterfaceCreate.

[in] dwProtocolId

Valor DWORD que especifica qué administrador de enrutadores está actualizando su información de enrutamiento. El enrutador usa un administrador de enrutadores diferente para cada protocolo de transporte. Los valores aceptables para dwTransportId se muestran en la tabla siguiente.

Valor	Transporte (familia de protocolos)
PID_ATALK	Appletalk
PID_IP	Protocolo de Internet versión 4
PID_IPX	Intercambio de paquetes de Internet
PID_NBF	Protocolo de marcos NetBIOS
PID_IPV6	Windows Server 2008 o posterior: Protocolo de Internet versión 6

[in] hEvent

Identificador de un evento que se señala cuando se ha completado el intento de actualizar la información de enrutamiento de la interfaz especificada. Si es NULL, la función es sincrónica. La aplicación que llama debe especificar NULL para este parámetro, si hMprServer especifica un enrutador remoto.

Valor devuelto

Si la función se realiza 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_INTERFACE_NOT_CONNECTED	La interfaz especificada no está conectada. Por lo tanto, no se pueden actualizar las rutas.
ERROR_INVALID_HANDLE	El valor hInterface no es válido.
ERROR_NO_SUCH_INTERFACE	El transporte especificado no se ejecuta en la interfaz especificada.
ERROR_UNKNOWN_PROTOCOL_ID	El valor dwTransportId no coincide con ninguno de los administradores del enrutador.
ERROR_UPDATE_IN_PROGRESS	Una operación de actualización de información de enrutamiento ya está en curso en esta interfaz.
PENDIENTE	La interfaz está en proceso de actualizar la información de enrutamiento. La aplicación que realiza la llamada debe esperar en el objeto de evento especificado por hEvent. Una vez señalado el evento, se puede obtener el estado de la operación de actualización llamando a MprAdminInterfaceQueryUpdateResult.

Comentarios

El parámetro dwTransportId especifica un protocolo de transporte y un administrador de enrutador único porque el enrutador usa un administrador de enrutadores diferente para cada transporte.

Requisitos

Requisito	Value
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

MprAdminInterfaceQueryUpdateResult

MprAdminServerConnect

Funciones de administración del enrutador

Referencia de administración de enrutadores