Fonction RtmGetChangeStatus (rtmv2.h)

Article
03/04/2024

La fonction RtmGetChangeStatus vérifie s’il existe des modifications en attente qui n’ont pas été récupérées avec RtmGetChangedDests.

Syntaxe

DWORD RtmGetChangeStatus(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_NOTIFY_HANDLE NotifyHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PBOOL             ChangeStatus
);

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.

[in] DestHandle

Gérez vers la destination pour laquelle retourner la modification status.

[out] ChangeStatus

En entrée, ChangeStatus est un pointeur vers une valeur BOOL .

À la sortie, ChangeStatus reçoit TRUE ou FALSE pour indiquer si la destination spécifiée par DestHandle a une notification de modification en attente.

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

Cette fonction peut être utilisée pour rendre des parties du code client plus efficaces. Par exemple, un client peut reporter une opération s’il n’a pas encore traité des modifications.

Cette fonction peut également être utilisée pour surveiller la notification de modification dans un autre thread.

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