RtmReleaseChangedDests-Funktion (rtmv2.h)

Artikel
03/01/2024

Die RtmReleaseChangedDests-Funktion gibt die geänderten Zielhandles frei.

Syntax

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

Gibt die Anzahl der Ziele in ChangedDests an.

[in] ChangedDests

Zeiger auf ein Array von RTM_DEST_INFO Strukturen, die freigegeben werden sollen. Die geänderten Ziele wurden aus einem vorherigen Aufruf von RtmGetChangedDests abgerufen.

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

Verwenden Sie diese Funktion immer, um geänderte RTM_DEST_INFO Strukturen freizugeben, die aus einem Aufruf von RtmGetChangedDests abgerufen wurden.

Die RTM_DEST_INFO-Struktur ist eine Struktur mit variabler Größe. Wenn ein Ziel Informationen für mehrere Ansichten enthält, nimmt die Größe der RTM_DEST_INFO für jede Ansicht zu. Verwenden Sie das Makro RTM_SIZE_OF_DEST_INFO , um zu bestimmen, wie groß ein ChangedDests-Puffer zugeordnet werden soll, bevor diese Funktion aufgerufen wird.

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