Функция RtmMarkDestForChangeNotification (rtmv2.h)

Статья
08/25/2023

Функция 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
Header	rtmv2.h
Библиотека	Rtm.lib
DLL	Rtm.dll

См. также раздел

RtmGetChangeStatus

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmRegisterForChangeNotification

RtmReleaseChangedDests

Поделиться через