Fonction RtmMarkDestForChangeNotification (rtmv2.h)
La fonction RtmMarkDestForChangeNotification marque une destination pour un client. Une destination marquée indique au gestionnaire de table de routage qu’elle doit envoyer les messages de notification de modification du client pour la destination marquée. Le client reçoit des messages de notification de modification lorsqu’une destination change. Les notifications de modification informent le client des modifications apportées aux informations de meilleur itinéraire pour la destination spécifiée. Cette fonction doit être utilisée lorsque RtmRegisterForChangeNotification est appelé pour demander des modifications pour des destinations spécifiques (RTM_NOTIFY_ONLY_MARKED_DESTS).
Syntaxe
DWORD RtmMarkDestForChangeNotification(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NOTIFY_HANDLE NotifyHandle,
[in] RTM_DEST_HANDLE DestHandle,
[in] BOOL MarkDest
);
Paramètres
[in] RtmRegHandle
Gérez le client obtenu à partir d’un appel précédent à RtmRegisterEntity.
[in] NotifyHandle
Gérez une notification de modification obtenue via un appel précédent à RtmRegisterForChangeNotification.
[in] DestHandle
Gérez la destination que le client marque pour la notification des modifications.
[in] MarkDest
Spécifie s’il faut marquer une destination et recevoir des notifications de modification. Spécifiez TRUE pour marquer une destination et commencer à recevoir des notifications de modification pour la destination spécifiée. Spécifiez FALSE pour arrêter la réception des notifications de modification d’une destination précédemment marquée.
Valeur retournée
Si la fonction réussit, la valeur de retour est NO_ERROR.
Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.
| Valeur | Signification |
|---|---|
|
Le handle n'est pas valide. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | rtmv2.h |
| Bibliothèque | Rtm.lib |
| DLL | Rtm.dll |
Voir aussi
RtmIsMarkedForChangeNotification