Partilhar via

Método ITsSbResourcePluginStoreEx::AcquireTargetLock

  • Artigo

Bloqueia um destino.

Sintaxe

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

Parâmetros

targetName [in]

O nome do destino a ser bloqueado.

dwTimeout [in]

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

ppContext [out]

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

Valor retornado

Se esse 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

esse bloqueio não impede 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.

Esse método está disponível no Windows Server 2012 R2 com KB3091411 instalado na interface ITsSbResourcePluginStoreEx.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Nenhum compatível
Servidor mínimo com suporte
 Windows Server 2012 R2
Fim do suporte ao servidor
 Windows Server 2012 R2
IDL
SbTsV.idl
IID
 IID_ITsSbResourcePluginStoreEx é definido como 80b83ffd-625d-11e5-bea1-a0481c7e9064

Confira também

ITsSbResourcePluginStoreEx