rtmMarkDestForChangeNotification 函数 (rtmv2.h)

  • 项目

RtmMarkDestForChangeNotification 函数标记客户端的目标。 标记的目标向路由表管理器指示它应发送标记目标的客户端更改通知消息。 当目标发生更改时，客户端会收到更改通知消息。 更改通知通知客户端有关指定目标的最佳路由信息的更改。 调用 RtmRegisterForChangeNotification 以请求对特定目标 (RTM_NOTIFY_ONLY_MARKED_DESTS) 的更改时，应使用此函数。

语法

DWORD RtmMarkDestForChangeNotification(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              MarkDest
);

参数

[in] RtmRegHandle

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

[in] NotifyHandle

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

[in] DestHandle

客户端为更改通知标记的目标的句柄。

[in] MarkDest

指定是否标记目标并接收更改通知。 指定 TRUE 以标记目标并开始接收指定目标的更改通知。 指定 FALSE 可停止接收以前标记的目标的更改通知。

返回值

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

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

值 含义
ERROR_INVALID_HANDLE
 该句柄无效。
 
 

要求

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

另请参阅

RtmGetChangeStatus

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmRegisterForChangeNotification

RtmReleaseChangedDests