IWABObject::AllocateMore method (wabapi.h)

Article
02/22/2024

Allocates a memory buffer that is linked to another buffer previously allocated with the IWABObject::AllocateBuffer method.

Syntax

HRESULT AllocateMore(
  ULONG  cbSize,
  LPVOID lpObject,
  LPVOID *lppBuffer
);

Parameters

cbSize

Type: ULONG

Value of type ULONG that specifies the size in bytes of the buffer to be allocated.

lpObject

Type: LPVOID

Pointer to the existing buffer object allocated using IWABObject::AllocateBuffer.

lppBuffer

Type: LPVOID*

Address of a pointer to the returned buffer. This buffer is linked to lpObject.

Return value

Type: HRESULT

Returns S_OK if successful.

Remarks

It is only possible to release a buffer allocated with IWABObject::AllocateMore by passing the buffer pointer specified in the lpObject parameter to IWABObject::FreeBuffer. The link between the memory buffers allocated with IWABObject::AllocateBuffer and IWABObject::AllocateMore enables IWABObject::FreeBuffer to release both buffers with a single call.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	wabapi.h
DLL	Wab32.dll

Share via