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.

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