Compartir a través de

Función MprAdminInterfaceQueryUpdateResult (mprapi.h)

  • Artículo

La función MprAdminInterfaceQueryUpdateResult devuelve el resultado de la última solicitud a un administrador de enrutador especificado para actualizar sus rutas para una interfaz. Para obtener más información, vea MprAdminInterfaceUpdateRoutes.

Sintaxis

DWORD MprAdminInterfaceQueryUpdateResult(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwProtocolId,
  [out] LPDWORD           lpdwUpdateResult
);

Parámetros

[in] hMprServer

Maneje al enrutador desde el que se está recuperando la información. Obtenga este identificador llamando a MprAdminServerConnect.

[in] hInterface

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

[in] dwProtocolId

Valor DWORD que especifica qué administrador de enrutadores se está consultando. El enrutador usa un administrador de enrutadores diferente para cada protocolo de transporte. Los valores aceptables para dwTransportId se enumeran 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

[out] lpdwUpdateResult

Puntero a una variable DWORD . Esta variable recibe el resultado de la última llamada a MprAdminInterfaceUpdateRoutes.

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_INTERFACE_NOT_CONNECTED
 La interfaz especificada no está conectada; el resultado de la última actualización ya no está disponible.
ERROR_INVALID_HANDLE
 El valor hInterface no es válido.
ERROR_INVALID_PARAMETER
 El parámetro lpdwUpdateResult es NULL.
ERROR_NO_SUCH_INTERFACE
 El transporte especificado no se está ejecutando en la interfaz especificada.
ERROR_UNKNOWN_PROTOCOL_ID
 El valor dwProtocolId no coincide con ningún administrador de enrutador compatible.

Comentarios

El parámetro dwProtocolId especifica un transporte y un administrador de enrutadores, ya que el enrutador mantiene un administrador de enrutadores 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

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

Funciones de administración del enrutador

Referencia de administración de enrutadores