Compartilhar via

Função RtmFindNextHop (rtmv2.h)

  • Artigo

A função RtmFindNextHop localiza um próximo salto específico na lista de próximo salto de um cliente.

Sintaxe

DWORD RtmFindNextHop(
  [in]  RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]  PRTM_NEXTHOP_INFO   NextHopInfo,
  [out] PRTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO   *NextHopPointer
);

Parâmetros

[in] RtmRegHandle

Manipule para o cliente obtido de uma chamada anterior para RtmRegisterEntity.

[in] NextHopInfo

Ponteiro para uma estrutura RTM_NEXTHOP_INFO que contém informações que identificam o próximo salto a ser encontrado. Use os membros NextHopAddress e InterfaceIndex para identificar o próximo salto a ser encontrado.

[out] NextHopHandle

Se um identificador precisar ser retornado: Na entrada, NextHopPointer será um ponteiro para NULL. Na saída, se o cliente possuir o próximo salto, NextHopPointer receberá um ponteiro para o identificador do próximo salto; caso contrário, NextHopPointer permanecerá inalterado.

Se um identificador não precisar ser retornado: na entrada, NextHopPointer será NULL.

[out] NextHopPointer

Se um ponteiro precisar ser retornado: Na entrada, NextHopPointer será um ponteiro para NULL. Na saída, se o cliente possuir o próximo salto, NextHopPointer receberá um ponteiro para o próximo salto; caso contrário, NextHopPointer permanecerá inalterado.

Se um ponteiro não precisar ser retornado: na entrada, NextHopPointer será NULL.

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 cliente de chamada não possui este próximo salto.
ERROR_NOT_FOUND
 O próximo salto especificado não foi encontrado.
 
 

Comentários

O NextHopPointer é válido desde que o cliente não tenha lançado NextHopHandle.

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

Confira também

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmGetNextHopPointer

RtmLockNextHop