Fonction RtmReleaseChangedDests (rtmv2.h)

Article
03/01/2024

La fonction RtmReleaseChangedDests libère les descripteurs de destination modifiés.

Syntaxe

DWORD RtmReleaseChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] 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] NumDests

Spécifie le nombre de destinations dans ChangedDests.

[in] ChangedDests

Pointeur vers un tableau de structures RTM_DEST_INFO à libérer. Les destinations modifiées ont été obtenues à partir d’un appel antérieur à RtmGetChangedDests.

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_HANDLE	Le handle n'est pas valide.

Remarques

Utilisez toujours cette fonction pour libérer les structures RTM_DEST_INFO modifiées obtenues à partir d’un appel à RtmGetChangedDests.

La structure RTM_DEST_INFO est une structure de taille variable. Si une destination contient des informations pour plusieurs vues, la taille de RTM_DEST_INFO augmente pour chaque vue. Utilisez la macro RTM_SIZE_OF_DEST_INFO pour déterminer la taille d’une mémoire tampon ChangedDests à allouer avant d’appeler cette fonction.

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