RtmReleaseDests 函数 (rtmv2.h)

RtmReleaseDests 函数释放目标句柄。

语法

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

[in] RtmRegHandle

从先前调用 RtmRegisterEntity 获取的客户端的句柄。

[in] NumDests

指定 DestInfos 中的目标数。

[in] DestInfos

指向要释放的 RTM_DEST_INFO 结构的数组的指针。这些目标是从先前对 RtmGetEnumDests 的调用中获取的。

如果函数成功，则返回值 NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值	含义
ERROR_INVALID_HANDLE	该句柄无效。

请勿使用此函数释放从对 RtmGetChangedDests 的调用获取的RTM_DEST_INFO结构。请改用 RtmReleaseChangedDests 。

RTM_DEST_INFO结构是大小可变的结构。如果目标包含多个视图的信息，则每个视图 RTM_DEST_INFO 的大小增加。使用 RTM_SIZE_OF_DEST_INFO 宏确定在调用此函数之前分配 DestInfos 缓冲区的大小。