Compartilhar via

Função RtmGetEnumNextHops (rtmv2.h)

  • Artigo

A função RtmGetEnumNextHops recupera o próximo conjunto de próximos saltos na enumeração especificada.

Sintaxe

DWORD RtmGetEnumNextHops(
  [in]      RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]      RTM_ENUM_HANDLE     EnumHandle,
  [in, out] PUINT               NumNextHops,
  [out]     PRTM_NEXTHOP_HANDLE NextHopHandles
);

Parâmetros

[in] RtmRegHandle

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

[in] EnumHandle

Manipule para a enumeração do próximo salto.

[in, out] NumNextHops

Na entrada, NumNextHops é um ponteiro para um valor UINT que especifica o número máximo de próximos saltos que podem ser recebidos por NextHopHandles.

Na saída, NumNextHops recebe o número real de próximos saltos recebidos por NextHopHandles.

[out] NextHopHandles

Na entrada, NextHopHandles ponteiros para uma estrutura RTM_NEXTHOP_INFO .

Na saída, NextHopHandles recebe uma matriz de identificadores para os próximos saltos.

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_INVALID_PARAMETER
 O valor apontado por NumRoutes é maior do que o número máximo de rotas que um cliente tem permissão para recuperar com uma chamada. Verifique RTM_REGN_PROFILE o número máximo de próximos saltos que o cliente tem permissão para recuperar com uma chamada.
ERROR_NO_MORE_ITEMS
 Não há mais próximos saltos para enumerar.
 
 

Comentários

Quando os próximos saltos não forem mais necessários, libere-os chamando RtmReleaseNextHops.

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

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops