Função RtmMarkDestForChangeNotification (rtmv2.h)

Artigo
03/05/2024

A função RtmMarkDestForChangeNotification marca um destino para um cliente. Um destino marcado indica ao gerenciador de tabelas de roteamento que ele deve enviar as mensagens de notificação de alteração do cliente para o destino marcado. O cliente recebe mensagens de notificação de alteração quando um destino é alterado. As notificações de alteração informam o cliente sobre as alterações nas informações de melhor rota para o destino especificado. Essa função deve ser usada quando RtmRegisterForChangeNotification é chamado para solicitar alterações para destinos específicos (RTM_NOTIFY_ONLY_MARKED_DESTS).

Sintaxe

DWORD RtmMarkDestForChangeNotification(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              MarkDest
);

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 obtida por meio de uma chamada anterior para RtmRegisterForChangeNotification.

[in] DestHandle

Manipule para o destino que o cliente está marcando para notificação de alterações.

[in] MarkDest

Especifica se um destino deve ser marcado e receber notificações de alteração. Especifique TRUE para marcar um destino e começar a receber notificações de alteração para o destino especificado. Especifique FALSE para parar de receber notificações de alteração de um destino marcado anteriormente.

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.

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

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmRegisterForChangeNotification

RtmReleaseChangedDests

Compartilhar via