Compartir a través de

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

  • Artículo

Bloquea un destino.

Sintaxis

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

Parámetros

[in] targetName

Nombre del destino que se va a bloquear.

[in] dwTimeout

Tiempo de espera de la operación, en milisegundos.

[out] ppContext

Devuelve un puntero al contexto del bloqueo. Para liberar el bloqueo, proporcione este puntero al método ReleaseTargetLock .

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Una vez adquirido el bloqueo, se supone que el subproceso que realiza la llamada tiene acceso exclusivo al objeto de destino y, por lo tanto, ningún otro subproceso (dentro de la misma máquina) puede actualizarlo. Por lo tanto, el subproceso que realiza la llamada debe llamar al método ReleaseTargetLock tan pronto como haya realizado las actualizaciones necesarias para el objeto de destino.

Importante Este bloqueo no impide que los objetos de destino se modifiquen externamente si existe más de un agente de conexión en la implementación. El subproceso de llamada debe estar preparado para controlar un error correctamente y volver a intentar la actualización de destino.
 

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado sbtsv.h

Consulte también

ITsSbResourcePluginStore