Compartilhar via


Função RtmIgnoreChangedDests (rtmv2.h)

A função RtmIgnoreChangedDests ignora a próxima alteração para cada destino se ela já tiver ocorrido. Essa função pode ser usada após RtmGetChangeStatus para impedir que o gerenciador de tabelas de roteamento retorne essa alteração em resposta a uma chamada para RtmGetChangedDests.

Sintaxe

DWORD RtmIgnoreChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_HANDLE  ChangedDests
);

Parâmetros

[in] RtmRegHandle

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

[in] NotifyHandle

Manipule para uma notificação de alteração.

[in] NumDests

Especifica o número de destinos em ChangedDests.

[in] ChangedDests

Ponteiro para uma matriz de identificadores de RTM_DEST_HANDLE que indicam os destinos para os quais ignorar quaisquer alterações pendentes.

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_INVALID_HANDLE
O manipulador é inválido.

Comentários

Quando os destinos não forem mais necessários, libere-os chamando RtmReleaseChangedDests.

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

RtmGetChangeStatus

RtmGetChangedDests

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification

RtmReleaseChangedDests