This is an old revision of the document!
Table of Contents
This is part of Win16 API which allow to create versions of program from one source code to run under OS/2 and Win16. Under OS/2 program can be running under Win-OS/2 if program is Windows NE executable, and with help on Windows Libraries for OS/2, if it is OS/2 NE executable. Here is a WLO to OS/2 API mapping draft
LocalInit
Brief
Initializes a local heap within a specified memory segment.
Syntax
BOOL LocalInit( WORD wSegment, WORD wOffset, WORD wHeapSize );
Parameters
- wSegment - The selector of the segment in which to initialize the local heap.
- wOffset - The offset within the segment at which the heap should start.
- wHeapSize - The size, in bytes, of the heap to initialize.
Return Code
- Returns non-zero if the heap is successfully initialized.
- Returns 0 if initialization fails.
Notes
- The function sets up a local heap manager within the provided segment, enabling local memory allocation functions to operate within that segment.
- Applications typically call LocalInit during initialization of a data segment or a dynamically allocated memory block intended for use as a local heap.
Example Code
C Binding
#include <windows.h> BOOL InitializeLocalHeap(WORD seg, WORD offset, WORD size) { return LocalInit(seg, offset, size); }
MASM Binding
; Assume AX = segment, DX = offset, CX = heap size push cx ; wHeapSize push dx ; wOffset push ax ; wSegment call LocalInit ; Returns AX = non-zero if success
See also
- LocalAlloc - Allocates memory from the local heap.
- LocalFree - Frees memory allocated from the local heap.
- LocalSize - Retrieves the size of a local memory block.
- LocalReAlloc - Reallocates a local memory block.




