Compartilhar via


Função RtmDeleteNextHop (rtmv2.h)

A função RtmDeleteNextHop exclui um próximo salto da lista do próximo salto.

Sintaxe

DWORD RtmDeleteNextHop(
  [in] RTM_ENTITY_HANDLE  RtmRegHandle,
  [in] RTM_NEXTHOP_HANDLE NextHopHandle,
  [in] PRTM_NEXTHOP_INFO  NextHopInfo
);

Parâmetros

[in] RtmRegHandle

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

[in] NextHopHandle

Manipule para o próximo salto a ser excluído. Esse parâmetro é opcional e pode ser definido como NULL; se for NULL, os valores em NextHopInfo serão usados para identificar o próximo salto a ser excluído.

[in] NextHopInfo

Ponteiro para uma estrutura que contém informações que identificam o próximo salto a ser excluído. Esse parâmetro é opcional e pode ser definido como NULL; se for NULL, o identificador em NextHopHandle será usado para identificar o próximo salto a ser excluído.

Valor retornado

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_NOT_ENOUGH_MEMORY
Não há memória suficiente para concluir essa operação.
ERROR_NOT_FOUND
O próximo salto especificado não foi encontrado.
 
 

Comentários

Se um cliente especificar um NextHopHandle, o cliente não deverá liberar posteriormente o identificador usando RtmReleaseNextHops.

Requisitos

   
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

RtmFindNextHop

RtmGetNextHopPointer