CreateILockBytesOnHGlobal.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

CreateILockBytesOnHGlobal (OLE32.@)

SYNOPSIS

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

DESCRIPTION

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

Defined in "ole2.h".

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

Debug channel "ole".