Função MprAdminInterfaceUpdateRoutes (mprapi.h)
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 |
|---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
A interface especificada não está conectada. Portanto, as rotas não podem ser atualizadas. |
|
O valor hInterface é inválido. |
|
O transporte especificado não está em execução na interface especificada. |
|
O valor dwTransportId não corresponde a nenhum dos gerenciadores de roteador. |
|
Uma operação de atualização de informações de roteamento já está em andamento nessa interface. |
|
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
MprAdminInterfaceQueryUpdateResult