Compartilhar via

Função MprAdminInterfaceQueryUpdateResult (mprapi.h)

  • Artigo

A função MprAdminInterfaceQueryUpdateResult retorna o resultado da última solicitação a um gerenciador de roteador especificado para atualizar suas rotas para uma interface. Para obter mais informações, consulte MprAdminInterfaceUpdateRoutes.

Sintaxe

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

Parâmetros

[in] hMprServer

Manipule para o roteador do qual as informações estão sendo recuperadas. Obtenha esse identificador chamando MprAdminServerConnect.

[in] hInterface

Manipule para a interface. Esse identificador é obtido de uma chamada anterior para MprAdminInterfaceCreate.

[in] dwProtocolId

Um valor DWORD que especifica qual gerenciador de roteador está sendo consultado. O roteador usa um gerenciador de roteador diferente para cada protocolo de transporte. Os valores aceitáveis para dwTransportId são listados na tabela a seguir.

Valor Transporte (Família de Protocolos)
PID_ATALK Appletalk
PID_IP Protocolo de Internet versão 4
PID_IPX Troca de Pacotes da Internet
PID_NBF Protocolo NetBIOS Frames
PID_IPV6 Windows Server 2008 ou posterior: Protocolo de Internet versão 6

[out] lpdwUpdateResult

Ponteiro para uma variável DWORD . Essa variável recebe o resultado da última chamada para MprAdminInterfaceUpdateRoutes.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor Significado
ERROR_ACCESS_DENIED
 O aplicativo de chamada não tem privilégios suficientes.
ERROR_INTERFACE_NOT_CONNECTED
 A interface especificada não está conectada; o resultado da última atualização não está mais disponível.
ERROR_INVALID_HANDLE
 O valor hInterface é inválido.
ERROR_INVALID_PARAMETER
 O parâmetro lpdwUpdateResult é NULL.
ERROR_NO_SUCH_INTERFACE
 O transporte especificado não está em execução na interface especificada.
ERROR_UNKNOWN_PROTOCOL_ID
 O valor dwProtocolId não corresponde a nenhum gerenciador de roteador com suporte.

Comentários

O parâmetro dwProtocolId especifica um transporte e um gerenciador de roteador, pois o roteador mantém um gerenciador de roteador para cada transporte.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

MprAdminInterfaceCreate

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

Funções de administração do roteador

Referência de gerenciamento de roteador