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

Метод ITsSbResourcePluginStoreEx::AcquireTargetLock

  • Статья

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

Синтаксис

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

Параметры

targetName [in]

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

dwTimeout [in]

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

ppContext [out]

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

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

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

Комментарии

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

Важно!

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

Этот метод доступен на Windows Server 2012 R2 с обновлением KB3091411, установленным в интерфейсе ITsSbResourcePluginStoreEx.

Требования

Требование Значение
Минимальная версия клиента
 Ни одна версия не поддерживается
Минимальная версия сервера
 Windows Server 2012 R2
Прекращение поддержки сервера
 Windows Server 2012 R2
IDL
SbTsV.idl
IID
 IID_ITsSbResourcePluginStoreEx определяется как 80b83ffd-625d-11e5-bea1-a0481c7e9064

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

ITsSbResourcePluginStoreEx