Edit

Share via

RtmReleaseDests function (rtmv2.h)

  • Article

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

See also

RTM_DEST_INFO

RtmCreateDestEnum

RtmDeleteEnumHandle

RtmGetEnumDests