Метод IDirectWriterLock::WaitForWriteAccess (objidl.h)

Метод WaitForWriteAccess получает монопольный доступ на запись к объекту хранилища.

Синтаксис

HRESULT WaitForWriteAccess(
  [in] DWORD dwTimeout
);

Параметры

[in] dwTimeout

Указывает время в миллисекундах, которое этот метод блокирует во время ожидания получения монопольного доступа на запись к объекту хранилища. Если dwTimeout равно нулю, метод не блокирует ожидание монопольного доступа для записи. Для dwTimeout разрешено время ожидания INFINITE, определенное в пакете SDK для платформы.

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

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

Код возврата	Описание
S_OK	Вызывающий объект успешно получил монопольный доступ на запись к хранилищу.
S_FALSE	Этот метод был вызван снова без промежуточного вызова IDirectWriterLock::ReleaseWriteAccess.
STG_E_INUSE	Указанное время ожидания истекло без получения монопольного доступа на запись.

Комментарии

При открытии хранилища в режиме прямого доступа (STGM_DIRECT) с помощью STGM_READWRITE|STGM_SHARE_DENY_WRITE этот метод можно вызвать для получения монопольного доступа на запись к хранилищу.

Этот метод возвращает немедленное возвращение, если хранилище не открыто ни в каких модулях чтения. Если хранилище по-прежнему открыто для чтения, этот метод блокирует указанный dwTimeout или пока текущие читатели не закроют хранилище.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	objidl.h
Библиотека	Uuid.lib
DLL	Ole32.dll

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

IDirectWriterLock::HaveWriteAccess

IDirectWriterLock::ReleaseWriteAccess