ILockBytes::UnlockRegion (Windows CE 5.0)
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