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。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
控制代碼無效。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | rtmv2.h |
程式庫 | Rtm.lib |
Dll | Rtm.dll |
另請參閱
RtmIsMarkedForChangeNotification