Метод 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 |