RtmReleaseDests-Funktion (rtmv2.h)

Die RtmReleaseDests-Funktion gibt die Zielhandles frei.

Syntax

DWORD RtmReleaseDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    DestInfos
);

Parameter

[in] RtmRegHandle

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

[in] NumDests

Gibt die Anzahl der Ziele in DestInfos an.

[in] DestInfos

Zeiger auf ein Array von RTM_DEST_INFO Strukturen, die freigegeben werden sollen. Die Ziele wurden aus einem vorherigen Aufruf von RtmGetEnumDests 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 nicht, um RTM_DEST_INFO Strukturen freizugeben , die aus einem Aufruf von RtmGetChangedDests abgerufen wurden. Verwenden Sie stattdessen RtmReleaseChangedDests .

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 DestInfos-Puffer zugeordnet werden soll, bevor Sie diese Funktion aufrufen.

Anforderungen

Weitere Informationen

RTM_DEST_INFO

RtmCreateDestEnum

RtmDeleteEnumHandle

RtmGetEnumDests