Метод ITsSbResourcePluginStore::AcquireTargetLock (sbtsv.h)
Блокирует целевой объект.
Синтаксис
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 |