RtmGetChangeStatus-Funktion (rtmv2.h)

Artikel
03/06/2024

Die RtmGetChangeStatus-Funktion überprüft, ob ausstehende Änderungen vorhanden sind, die nicht mit RtmGetChangedDests abgerufen wurden.

Syntax

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

Parameter

[in] RtmRegHandle

Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] NotifyHandle

Behandeln sie eine Änderungsbenachrichtigung.

[in] DestHandle

Handle an das Ziel, für das Änderungs-status zurückgegeben werden soll.

[out] ChangeStatus

Bei der Eingabe ist ChangeStatus ein Zeiger auf einen BOOL-Wert .

Bei der Ausgabe empfängt ChangeStatus entweder TRUE oder FALSE , um anzugeben, ob für das von DestHandle angegebene Ziel eine Änderungsbenachrichtigung aussteht.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Diese Funktion kann verwendet werden, um Teile des Clientcodes effizienter zu gestalten. Beispielsweise kann ein Client einen Vorgang verschieben, wenn Änderungen vorliegen, die der Client noch nicht verarbeitet hat.

Diese Funktion kann auch verwendet werden, um Änderungsbenachrichtigungen in einem anderen Thread zu überwachen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rtmv2.h
Bibliothek	Rtm.lib
DLL	Rtm.dll