Share via

ILockBytes::UnlockRegion

  • Article

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.

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.