RtmGetChangedDests-Funktion (rtmv2.h)

Artikel
03/01/2024

Die RtmGetChangedDests-Funktion gibt einen Satz von Zielen mit geänderten Informationen zurück.

Syntax

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

Parameter

[in] RtmRegHandle

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

[in] NotifyHandle

Handle für eine Änderungsbenachrichtigung, die von einem vorherigen Aufruf von RtmRegisterForChangeNotification abgerufen wurde.

[in, out] NumDests

NumDests ist bei der Eingabe ein Zeiger auf einen UINT-Wert, der die maximale Anzahl von Zielen angibt, die von ChangedDests empfangen werden können.

Bei der Ausgabe empfängt NumDests die tatsächliche Anzahl von Zielen, die von ChangedDests empfangen wurden.

[out] ChangedDests

Bei der Eingabe ist ChangedDests ein Zeiger auf ein Array von RTM_DEST_INFO Strukturen.

Bei der Ausgabe wird ChangedDests mit den geänderten Zielinformationen gefüllt.

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_PARAMETER	Ein Parameter enthält falsche Informationen.
ERROR_NO_MORE_ITEMS	Es müssen keine geänderten Ziele mehr abgerufen werden.

Hinweise

Ein Client wird von einer RTM_EVENT_CALLBACK über Änderungen benachrichtigt. Die RTM_EVENT_CALLBACK wird nur verwendet, um den Client zu benachrichtigen, nicht um die Änderungen zu übermitteln. Nachdem eine Änderungsbenachrichtigung empfangen wurde, muss der Client RtmGetChangedDests wiederholt aufrufen, um alle Änderungen abzurufen.

Wenn seit der Benachrichtigung zwei oder mehr Änderungen am gleichen Ziel vorgenommen wurden, wird nur die letzte Änderung zurückgegeben.

Wenn ein Client die Handles in ChangedDests nicht mehr benötigt, muss der Client RtmReleaseChangedDests verwenden, um die Handles freizugeben.

Beispielcode mit dieser Funktion finden Sie unter Verwenden des Ereignisbenachrichtigungsrückrufs.

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