Função RtmGetNextHopPointer (rtmv2.h)
A função RtmGetNextHopPointer obtém um ponteiro direto para o próximo salto especificado. O ponteiro permite ao proprietário do próximo salto acesso direto de leitura à estrutura RTM_NEXTHOP_INFO do gerenciador de tabelas de roteamento.
Sintaxe
DWORD RtmGetNextHopPointer(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NEXTHOP_HANDLE NextHopHandle,
[out] PRTM_NEXTHOP_INFO *NextHopPointer
);
Parâmetros
[in] RtmRegHandle
Identificador para o cliente obtido de uma chamada anterior para RtmRegisterEntity.
[in] NextHopHandle
Manipule para o próximo salto.
[out] NextHopPointer
Se o cliente for o proprietário do próximo salto, NextHopPointer receberá um ponteiro para o próximo salto.
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 cliente de chamada não possui este próximo salto. |
|
O manipulador é inválido. |
Comentários
Os clientes só devem usar esse ponteiro para acesso somente leitura.
Quando o identificador do próximo salto não for mais necessário, libere-o chamando RtmReleaseNextHopInfo.
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 | rtmv2.h |
| Biblioteca | Rtm.lib |
| DLL | Rtm.dll |