AllocateHeap function

The AllocateHeap function allocates memory on the heap. Memory allocated with this routine must be freed using the FreeHeap function.

Syntax

c++

PVOID AllocateHeap(
  _In_ ULONG Length
);

Parameters

• Length [in]
  Number of bytes to allocate.

Return value

This function returns a pointer to the allocated memory. If memory could not be allocated, the function returns NULL.

Remarks

To free memory allocated by the AllocateHeap function use the FreeHeap function.

A pointer to the AllocateHeap function is available in the SECPKG_DLL_FUNCTIONS structure received from the SpInstanceInit function.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Ntsecpkg.h

See also

FreeHeap

SECPKG_DLL_FUNCTIONS

SpInstanceInit