rtmGetChangeStatus 函数 (rtmv2.h)
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。
如果函数失败,则返回值为以下错误代码之一。
值 | 含义 |
---|---|
|
该句柄无效。 |
注解
此函数可用于提高部分客户端代码的效率。 例如,如果客户端尚未处理的更改,则客户端可能会推迟某些操作。
此函数还可用于监视另一个线程中的更改通知。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | rtmv2.h |
Library | Rtm.lib |
DLL | Rtm.dll |
另请参阅
RtmIsMarkedForChangeNotification