Compartilhar via

Função MprAdminInterfaceUpdateRoutes (mprapi.h)

  • Artigo

A função MprAdminInterfaceUpdateRoutes solicita que um gerenciador de roteador especificado atualize suas informações de roteamento para uma interface especificada.

Sintaxe

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

Parâmetros

[in] hMprServer

Identificador para o roteador no qual as informações estão sendo atualizadas. Obtenha esse identificador chamando MprAdminServerConnect.

[in] hInterface

Identificador para a interface que está sendo atualizada. Obtenha esse identificador chamando MprAdminInterfaceCreate.

[in] dwProtocolId

Um valor DWORD que especifica qual gerenciador de roteador está atualizando suas informações de roteamento. O roteador usa um gerenciador de roteador diferente para cada protocolo de transporte. Os valores aceitáveis para dwTransportId estão listados na tabela a seguir.

Valor Transporte (Família de Protocolos)
PID_ATALK Appletalk
PID_IP Protocolo 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

[in] hEvent

Identificador para um evento que é sinalizado quando a tentativa de atualizar informações de roteamento para a interface especificada foi concluída. Se FOR NULL, a função será síncrona. O aplicativo de chamada deve especificar NULL para esse parâmetro, se hMprServer especificar um roteador remoto.

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 códigos de erro a seguir.

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. Portanto, as rotas não podem ser atualizadas.
ERROR_INVALID_HANDLE
 O valor hInterface é inválido.
ERROR_NO_SUCH_INTERFACE
 O transporte especificado não está em execução na interface especificada.
ERROR_UNKNOWN_PROTOCOL_ID
 O valor dwTransportId não corresponde a nenhum dos gerenciadores de roteador.
ERROR_UPDATE_IN_PROGRESS
 Uma operação de atualização de informações de roteamento já está em andamento nessa interface.
PENDENTE
 A interface está em processo de atualização de informações de roteamento. O aplicativo de chamada deve aguardar o objeto de evento especificado por hEvent. Depois que o evento é sinalizado, o status da operação de atualização pode ser obtido chamando MprAdminInterfaceQueryUpdateResult.

Comentários

O parâmetro dwTransportId especifica um protocolo de transporte e um gerenciador de roteador exclusivo porque o roteador usa um gerenciador de roteador diferente 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

MprAdminInterfaceQueryUpdateResult

MprAdminServerConnect

Funções de administração do roteador

Referência de gerenciamento de roteador