RtmMarkDestForChangeNotification 函式 (rtmv2.h)

發行項
03/01/2024

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
程式庫	Rtm.lib
Dll	Rtm.dll