RtmGetChangedDests 函数 (rtmv2.h)
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。
如果函数失败，则返回值为以下错误代码之一。
| 值 | 含义 |
|---|---|
|
参数包含不正确的信息。 |
|
不再有要检索的已更改目标。 |
注解
RTM_EVENT_CALLBACK通知客户端更改。 RTM_EVENT_CALLBACK仅用于通知客户端，而不是传递更改。 收到更改通知后，客户端必须重复调用 RtmGetChangedDests 以检索所有更改。
如果在通知后对同一目标进行了两次或更多更改，则仅返回最新更改。
当客户端不再需要 ChangedDests 中的句柄时，客户端必须使用 RtmReleaseChangedDests 释放句柄。
有关使用此函数的示例代码，请参阅 使用事件通知回调。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | rtmv2.h |
| Library | Rtm.lib |
| DLL | Rtm.dll |
另请参阅
RtmIsMarkedForChangeNotification