Метод ITsSbResourcePluginStore::AcquireTargetLock (sbtsv.h)

Статья
03/05/2024

Блокирует целевой объект.

Синтаксис

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

Параметры

[in] targetName

Имя целевого объекта для блокировки.

[in] dwTimeout

Время ожидания операции в миллисекундах.

[out] ppContext

Возвращает указатель на контекст блокировки. Чтобы освободить блокировку, укажите этот указатель на метод ReleaseTargetLock .

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

После получения блокировки предполагается, что вызывающий поток имеет монопольный доступ к целевому объекту, и поэтому ни один другой поток (на том же компьютере) не может обновить его. Поэтому вызывающий поток должен вызывать метод ReleaseTargetLock сразу после внесения необходимых обновлений в целевой объект.

Важно! Эта блокировка не полностью предотвращает изменение целевых объектов извне, если в развертывании существует несколько посредников подключений. Вызывающий поток должен быть подготовлен к корректной обработке сбоя и повторному выполнению целевого обновления.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2016
Целевая платформа	Windows
Header	sbtsv.h

См. также раздел

ITsSbResourcePluginStore

Поделиться через