RtmReleaseChangedDests 函数 (rtmv2.h)

项目
03/01/2024

RtmReleaseChangedDests 函数释放已更改的目标句柄。

语法

DWORD RtmReleaseChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    ChangedDests
);

参数

[in] RtmRegHandle

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

[in] NotifyHandle

更改通知的句柄，从先前调用 RtmRegisterForChangeNotification 获取。

[in] NumDests

指定 ChangedDests 中的目标数。

[in] ChangedDests

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

返回值

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

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

值	含义
ERROR_INVALID_HANDLE	该句柄无效。

注解

始终使用此函数释放通过调用 RtmGetChangedDests 获取的已更改RTM_DEST_INFO结构。

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

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	rtmv2.h
Library	Rtm.lib
DLL	Rtm.dll