---
name: "CreateILockBytesOnHGlobal"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/CreateILockBytesOnHGlobal"
---

# CreateILockBytesOnHGlobal(3w)

## 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

Declared in **"ole2.h"**.

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

Debug channel **"ole"**.