Метод ITextStoreAnchorSink::OnLockGranted (texttor.h)

  • Статья

Вызывается для предоставления блокировки документа.

Синтаксис

HRESULT OnLockGranted(
  [in] DWORD dwLockFlags
);

Параметры

[in] dwLockFlags

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

Значение Значение
TS_LF_READ
 Блокировка доступна только для чтения.
TS_LF_READWRITE
 Блокировка выполняется для чтения и записи.

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

Этот метод может возвращать одно из этих значений.

Значение Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 DwLockFlags недопустим.
E_UNEXPECTED
 Предоставлен неправильный тип блокировки.

Комментарии

Блокировка документа запрашивается путем вызова ITextStoreAnchor::RequestLock. Приложение предоставляет запрос на блокировку, вызывая метод ITextStoreAnchorSink::OnLockGranted с запрошенным типом блокировки. Блокировка действительна только во время вызова OnLockGranted . При возврате OnLockGranted документ считается незаблокированным.

Тип блокировки, указанный в dwLockFlags, должен совпадать с запрошенным типом блокировки в соответствующем вызове ITextStoreAnchor::RequestLock.

Вызовы ITextStoreAnchor::RequestLock из OnLockGranted возвращают значение ошибки.

Приложения не должны вызывать методы ITextStoreAnchorSink из контекста OnLockGranted.

Если синхронный запрос на блокировку выполняется из ITextStoreAnchor::RequestLock, вызывающий объект также должен предоставить возвращаемое значение из ITextStoreAnchor::RequestLock.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header textstor.h
DLL Msctf.dll
Распространяемые компоненты TSF 1.0 в Windows 2000 Professional

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

Блокировки документов

ITextStoreAnchor::RequestLock

ITextStoreAnchorSink

константы TS_LF_*