Función RtmBlockMethods (rtmv2.h)

La función RtmBlockMethods bloquea o desbloquea la ejecución de métodos para un destino, una ruta o un próximo salto especificados, o para todos los destinos, rutas y próximo saltos.

Sintaxis

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

Parámetros

[in] RtmRegHandle

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] TargetHandle

Controlar a un destino, una ruta o un próximo salto para el que se van a bloquear los métodos. Este parámetro es opcional y se puede establecer en NULL para bloquear métodos para todos los destinos.

[in] TargetType

Especifica el tipo del identificador en TargetHandle. Este parámetro es opcional y se puede establecer en NULL para bloquear métodos para todos los destinos. Se usan las marcas siguientes.

[in] BlockingFlag

Especifica si se van a bloquear o desbloquear métodos. Se usan las marcas siguientes.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es el siguiente código de error.

Comentarios

Actualmente, esta función no admite métodos de bloqueo para un destino, una ruta o un próximo salto específicos.

Normalmente, los métodos se bloquean cuando se cambian datos específicos del cliente en la ruta; Un cliente bloquea los métodos, reorganiza los datos y, a continuación, desbloquea los métodos.

Los clientes solo deben bloquear métodos durante un breve período de tiempo. Si un segundo cliente llama a RtmInvokeMethod y se bloquean los métodos del primer cliente, RtmInvokeMethod no devuelve hasta que se desbloquean los métodos y se completa la llamada de función.

Requisitos

Consulte también

RtmGetEntityMethods

RtmInvokeMethod