Fonction RtmGetChangedDests (rtmv2.h)

Article
03/04/2024

La fonction RtmGetChangedDests retourne un ensemble de destinations avec des informations modifiées.

Syntaxe

DWORD RtmGetChangedDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_NOTIFY_HANDLE NotifyHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    ChangedDests
);

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 à partir d’un appel précédent à RtmRegisterForChangeNotification.

[in, out] NumDests

En entrée, NumDests est un pointeur vers une valeur UINT qui spécifie le nombre maximal de destinations pouvant être reçues par ChangedDests.

À la sortie, NumDests reçoit le nombre réel de destinations reçues par ChangedDests.

[out] ChangedDests

En entrée, ChangedDests est un pointeur vers un tableau de structures RTM_DEST_INFO .

Dans la sortie, ChangedDests est rempli avec les informations de destination modifiées.

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
ERROR_INVALID_PARAMETER	Un paramètre contient des informations incorrectes.
ERROR_NO_MORE_ITEMS	Plus de destinations modifiées à récupérer.

Remarques

Un client est averti des modifications par un RTM_EVENT_CALLBACK. Le RTM_EVENT_CALLBACK est utilisé uniquement pour notifier le client, et non pour remettre les modifications. Une fois une notification de modification reçue, le client doit appeler RtmGetChangedDests à plusieurs reprises pour récupérer toutes les modifications.

Si plusieurs modifications apportées à la même destination se sont produites depuis la notification, seule la dernière modification est retournée.

Lorsqu’un client n’a plus besoin des handles dans ChangedDests, il doit utiliser RtmReleaseChangedDests pour libérer les handles.

Pour obtenir un exemple de code utilisant cette fonction, consultez Utiliser le rappel de notification d’événement.

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