RtmReleaseChangedDests-Funktion (rtmv2.h)

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.

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

Weitere Informationen

RTM_DEST_INFO

RtmGetChangeStatus

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification