Compartilhar via

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
ERROR_ACCESS_DENIED
 O cliente de chamada não possui este próximo salto.
ERROR_INVALID_HANDLE
 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

Confira também

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmFindNextHop

RtmLockNextHop

  • Last updated on