rtmGetChangeStatus 函数 (rtmv2.h)

项目
03/05/2024

RtmGetChangeStatus 函数检查是否存在尚未使用 RtmGetChangedDests 检索的挂起更改。

语法

DWORD RtmGetChangeStatus(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_NOTIFY_HANDLE NotifyHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PBOOL             ChangeStatus
);

参数

[in] RtmRegHandle

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

[in] NotifyHandle

更改通知的句柄。

[in] DestHandle

要返回其更改状态的目标的句柄。

[out] ChangeStatus

输入时， ChangeStatus 是指向 BOOL 值的指针。

在输出时， ChangeStatus 接收 TRUE 或 FALSE ，以指示 DestHandle 指定的目标是否有挂起的更改通知。

返回值

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

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

值	含义
ERROR_INVALID_HANDLE	该句柄无效。

注解

此函数可用于提高部分客户端代码的效率。例如，如果客户端尚未处理的更改，则客户端可能会推迟某些操作。

此函数还可用于监视另一个线程中的更改通知。

要求

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