RtmReleaseDests function (rtmv2.h)

Article
10/13/2021

The RtmReleaseDests function releases the destination handles.

Syntax

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

Parameters

[in] RtmRegHandle

Handle to the client obtained from a previous call to RtmRegisterEntity.

[in] NumDests

Specifies the number of destinations in DestInfos.

[in] DestInfos

Pointer to an array of RTM_DEST_INFO structures to release. The destinations were obtained from a previous call to RtmGetEnumDests.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value	Meaning
ERROR_INVALID_HANDLE	The handle is invalid.

Remarks

Do not use this function to release RTM_DEST_INFO structures obtained from a call to RtmGetChangedDests. Use RtmReleaseChangedDests instead.

The RTM_DEST_INFO structure is a variable-sized structure. If a destination contains information for more than one view, the size of RTM_DEST_INFO increases for each view. Use the RTM_SIZE_OF_DEST_INFO macro to determine how large a DestInfos buffer to allocate before calling this function.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	rtmv2.h
Library	Rtm.lib
DLL	Rtm.dll