Share via


ILockBytes::UnlockRegion

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method removes the access restriction on a range of bytes previously restricted with the ILockBytes::LockRegion method.

Syntax

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 Value

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

Header objidl.h, objidl.idl
Library ole32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later