Funzione RtmGetChangeStatus (rtmv2.h)

Articolo
03/05/2024

La funzione RtmGetChangeStatus verifica se sono presenti modifiche in sospeso che non sono state recuperate con RtmGetChangedDests.

Sintassi

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

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] NotifyHandle

Gestire una notifica di modifica.

[in] DestHandle

Gestire la destinazione per cui restituire lo stato di modifica.

[out] ChangeStatus

In input ChangeStatus è un puntatore a un valore BOOL .

Nell'output ChangeStatus riceve TRUE o FALSE per indicare se la destinazione specificata da DestHandle ha una notifica di modifica in sospeso.

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.

Commenti

Questa funzione può essere usata per rendere più efficienti le parti del codice client. Ad esempio, un client può rinviare un'operazione se sono presenti modifiche che il client non ha ancora elaborato.

Questa funzione può essere usata anche per monitorare la notifica delle modifiche in un altro thread.

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