Compartilhar via

Método ITsSbResourcePluginStore::AcquireTargetLock (sbtsv.h)

  • Artigo

Bloqueia um destino.

Sintaxe

HRESULT AcquireTargetLock(
  [in]  BSTR     targetName,
  [in]  DWORD    dwTimeout,
  [out] IUnknown **ppContext
);

Parâmetros

[in] targetName

O nome do destino a ser bloqueado.

[in] dwTimeout

O tempo limite para a operação, em milissegundos.

[out] ppContext

Retorna um ponteiro para o contexto do bloqueio. Para liberar o bloqueio, forneça esse ponteiro para o método ReleaseTargetLock .

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Depois que o bloqueio é adquirido, supõe-se que o thread de chamada tenha acesso exclusivo ao objeto de destino e, portanto, nenhum outro thread (dentro do mesmo computador) pode atualizá-lo. Portanto, o thread de chamada deve chamar o método ReleaseTargetLock assim que tiver feito as atualizações necessárias para o objeto de destino.

É importante que esse bloqueio não impeça completamente que objetos de destino sejam modificados externamente se mais de um Agente de Conexão existir na implantação. O thread de chamada deve estar preparado para lidar com uma falha normalmente e repetir a atualização de destino.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho sbtsv.h

Confira também

ITsSbResourcePluginStore