Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This method removes the access restriction on a range of bytes previously restricted with the ILockBytes::LockRegion method.
HRESULT UnlockRegion( ULARGE_INTEGER libOffset, ULARGE_INTEGER cb, DWORD dwLockType );
Parameters
libOffset
[in] Byte offset for the beginning of the range.cb
[in] Length, in bytes,of the range that is restricted.dwLockType
[in] Type of access restrictions previously placed on the range.This parameter uses a value from the LOCKTYPE enumeration.
Return Values
The following table shows the return values for this method.
| Value | Description |
|---|---|
| S_OK | The byte range was unlocked. |
| STG_E_INVALIDFUNCTION | Locking is not supported at all or the specific type of lock requested is not supported. |
| STG_E_LOCKVIOLATION | The requested unlock cannot be granted. |
Remarks
ILockBytes::UnlockRegion unlocks a region previously locked with a call to ILockBytes::LockRegion.
Each region locked must be explicitly unlocked, using the same values for the libOffset, cb, and dwLockType parameters as in the matching calls to ILockBytes::LockRegion.
Two adjacent regions cannot be locked separately and then unlocked with a single unlock call.
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Objidl.h, Objidl.idl.
Link Library: Ole32.lib, Uuid.lib.
Send Feedback on this topic to the authors