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

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

  • Статья

Функция RtmBlockMethods блокирует или разблокирует выполнение методов для указанного назначения, маршрута или следующего прыжка либо для всех назначений, маршрутов и следующих прыжков.

Синтаксис

DWORD RtmBlockMethods(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] HANDLE            TargetHandle,
  [in] UCHAR             TargetType,
  [in] DWORD             BlockingFlag
);

Параметры

[in] RtmRegHandle

Дескриптор клиента, полученного из предыдущего вызова RtmRegisterEntity.

[in] TargetHandle

Обработка до назначения, маршрута или следующего прыжка, для которого необходимо заблокировать методы. Этот параметр является необязательным и может иметь значение NULL , чтобы блокировать методы для всех целевых объектов.

[in] TargetType

Указывает тип дескриптора в TargetHandle. Этот параметр является необязательным и может иметь значение NULL , чтобы блокировать методы для всех целевых объектов. Используются следующие флаги.

Тип Значение
DEST_TYPE
 TargetHandle — это назначение.
NEXTHOP_TYPE
 TargetHandle — это следующий прыжок.
ROUTE_TYPE
 TargetHandle — это маршрут.

[in] BlockingFlag

Указывает, следует ли блокировать или разблокировать методы. Используются следующие флаги.

Константа Значение
RTM_BLOCK_METHODS
 Блокировать методы для указанного целевого объекта.
RTM_RESUME_METHODS
 Разблокируйте методы для указанного целевого объекта.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой следующий код ошибки.

Значение Значение
ERROR_INVALID_HANDLE
 Дескриптор недействителен.
 
 

Комментарии

В настоящее время эта функция не поддерживает методы блокировки для определенного назначения, маршрута или следующего прыжка.

Методы обычно блокируются при изменении данных клиента в маршруте; клиент блокирует методы, изменяет порядок данных, а затем разблокирует методы.

Клиенты должны блокировать методы только на короткий период времени. Если второй клиент вызывает RtmInvokeMethod и методы первого клиента блокируются, rtmInvokeMethod не возвращается до тех пор, пока методы не будут разблокированы и вызов функции не будет завершен.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header rtmv2.h
Библиотека Rtm.lib
DLL Rtm.dll

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

RtmGetEntityMethods

RtmInvokeMethod