Compartilhar via

Função RtmBlockMethods (rtmv2.h)

  • Artigo

A função RtmBlockMethods bloqueia ou desbloqueia a execução de métodos para um destino, rota ou próximo salto especificado, ou para todos os destinos, rotas e próximos saltos.

Sintaxe

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

Parâmetros

[in] RtmRegHandle

Manipule para o cliente obtido de uma chamada anterior para RtmRegisterEntity.

[in] TargetHandle

Manipule para um destino, rota ou próximo salto para o qual bloquear métodos. Esse parâmetro é opcional e pode ser definido como NULL para bloquear métodos para todos os destinos.

[in] TargetType

Especifica o tipo do identificador em TargetHandle. Esse parâmetro é opcional e pode ser definido como NULL para bloquear métodos para todos os destinos. Os sinalizadores a seguir são usados.

Type Significado
DEST_TYPE
 TargetHandle é um destino.
NEXTHOP_TYPE
 TargetHandle é um próximo salto.
ROUTE_TYPE
 TargetHandle é uma rota.

[in] BlockingFlag

Especifica se os métodos devem ser bloqueados ou desbloqueados. Os sinalizadores a seguir são usados.

Constante Significado
RTM_BLOCK_METHODS
 Bloquear métodos para o destino especificado.
RTM_RESUME_METHODS
 Desbloqueie métodos para o destino especificado.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será o código de erro a seguir.

Valor Significado
ERROR_INVALID_HANDLE
 O manipulador é inválido.
 
 

Comentários

Atualmente, essa função não dá suporte a métodos de bloqueio para um destino, rota ou próximo salto específico.

Os métodos normalmente são bloqueados quando dados específicos do cliente na rota estão sendo alterados; um cliente bloqueia métodos, reorganiza dados e desbloqueia métodos.

Os clientes só devem bloquear métodos por um curto período de tempo. Se um segundo cliente chamar RtmInvokeMethod e os métodos do primeiro cliente forem bloqueados, RtmInvokeMethod não retornará até que os métodos sejam desbloqueados e a chamada de função seja concluída.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rtmv2.h
Biblioteca Rtm.lib
DLL Rtm.dll

Confira também

RtmGetEntityMethods

RtmInvokeMethod