CreateILockBytesOnHGlobal(3w)

CreateILockBytesOnHGlobal3w

Usage

HRESULT CreateILockBytesOnHGlobal
(
HGLOBAL hGlobal,
BOOL fDeleteOnRelease,
LPLOCKBYTES* ppLkbyt
)

Overview

Create a byte array object which is intended to be the compound file foundation. This object supports a COM implementation of the ILockBytes interface.

Params

hGlobal [ I] Global memory handle

fDeleteOnRelease [ I] Whether the handle should be freed when the object is released.

ppLkbyt [ O] Address of ILockBytes pointer that receives the interface pointer to the new byte array object.

Returns

Success: S_OK.

Notes

The supplied ILockBytes pointer can be used by the StgCreateDocfileOnILockBytes function to build a compound file on top of this byte array object. The ILockBytes interface instance calls the GlobalReAlloc function to grow the memory block as required.

Implementation

Declared in "ole2.h".

Implemented in "dlls/ole32/memlockbytes.c".

Debug channel "ole".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.