RtmGetChangedDests 函数 (rtmv2.h)

项目
03/01/2024

RtmGetChangedDests 函数返回一组包含更改信息的目标。

语法

DWORD RtmGetChangedDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_NOTIFY_HANDLE NotifyHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    ChangedDests
);

参数

[in] RtmRegHandle

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

[in] NotifyHandle

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

[in, out] NumDests

输入时， NumDests 是指向 UINT 值的指针，该值指定 ChangedDests 可以接收的最大目标数。

输出时， NumDests 接收 ChangedDests 接收的实际目标数。

[out] ChangedDests

输入时， ChangedDests 是指向 RTM_DEST_INFO 结构的数组的指针。

在输出中， ChangedDests 将填充已更改的目标信息。

返回值

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

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

值	含义
ERROR_INVALID_PARAMETER	参数包含不正确的信息。
ERROR_NO_MORE_ITEMS	不再有要检索的已更改目标。

注解

RTM_EVENT_CALLBACK通知客户端更改。 RTM_EVENT_CALLBACK仅用于通知客户端，而不是传递更改。收到更改通知后，客户端必须重复调用 RtmGetChangedDests 以检索所有更改。

如果在通知后对同一目标进行了两次或更多更改，则仅返回最新更改。

当客户端不再需要 ChangedDests 中的句柄时，客户端必须使用 RtmReleaseChangedDests 释放句柄。

有关使用此函数的示例代码，请参阅使用事件通知回调。

要求

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