Funzione RtmMarkDestForChangeNotification (rtmv2.h)

Articolo
03/01/2024

La funzione RtmMarkDestForChangeNotification contrassegna una destinazione per un client. Una destinazione contrassegnata indica alla gestione tabelle di routing che deve inviare i messaggi di notifica delle modifiche client per la destinazione contrassegnata. Il client riceve messaggi di notifica di modifica quando viene modificata una destinazione. Le notifiche di modifica informano il client delle modifiche alle informazioni di route consigliate per la destinazione specificata. Questa funzione deve essere usata quando RtmRegisterForChangeNotification viene chiamato per richiedere modifiche per destinazioni specifiche (RTM_NOTIFY_ONLY_MARKED_DESTS).

Sintassi

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

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] NotifyHandle

Gestire una notifica di modifica ottenuta tramite una chiamata precedente a RtmRegisterForChangeNotification.

[in] DestHandle

Gestire la destinazione che il client contrassegna per la notifica delle modifiche.

[in] MarkDest

Specifica se contrassegnare una destinazione e ricevere notifiche di modifica. Specificare TRUE per contrassegnare una destinazione e avviare le notifiche di modifica per la destinazione specificata. Specificare FALSE per interrompere la ricezione di notifiche di modifica in una destinazione contrassegnata in precedenza.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_HANDLE	Handle non valido.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

RtmGetChangeStatus

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmRegisterForChangeNotification

RtmReleaseChangedDests

Condividi tramite