Метод ILockBytes::UnlockRegion (objidl.h)

  • Статья

Метод UnlockRegion удаляет ограничение доступа для ранее заблокированного диапазона байтов.

Синтаксис

HRESULT UnlockRegion(
  [in] ULARGE_INTEGER libOffset,
  [in] ULARGE_INTEGER cb,
  [in] DWORD          dwLockType
);

Параметры

[in] libOffset

Задает смещение в байтах для начала диапазона.

[in] cb

Указывает в байтах длину ограниченного диапазона.

[in] dwLockType

Указывает тип ограничений доступа, ранее введенных в диапазон. Этот параметр использует значение из перечисления LOCKTYPE .

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

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

Код возврата Описание
S_OK Диапазон байтов был разблокирован.
STG_E_INVALIDFUNCTION Блокировка не поддерживается вообще или конкретный тип запрошенной блокировки не поддерживается.
STG_E_LOCKVIOLATION Запрошенная разблокировка не может быть предоставлена.

Комментарии

ILockBytes::UnlockRegion разблокирует регион, ранее заблокированный с помощью вызова ILockBytes::LockRegion. Каждый заблокированный регион должен быть явно разблокирован, используя те же значения для параметров libOffset, cb и dwLockType , что и в соответствующих вызовах ILockBytes::LockRegion. Два смежных региона нельзя заблокировать отдельно, а затем разблокировать с помощью одного вызова разблокировки.

Требования

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

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

ILockBytes — реализация File-Based

ILockBytes — реализация глобальной памяти

ILockBytes::LockRegion

LOCKTYPE