IMAPISupport::GetMemAllocRoutines

The IMAPISupport::GetMemAllocRoutines method retrieves the addresses of the MAPI memory allocation and deallocation functions: MAPIAllocateBuffer, MAPIAllocateMore, and MAPIFreeBuffer.

Quick Info

See IMAPISupport : IUnknown.

HRESULT GetMemAllocRoutines(
  LPALLOCATEBUFFER FAR * lppAllocateBuffer,   
  LPALLOCATEMORE FAR * lppAllocateMore,   
  LPFREEBUFFER FAR * lppFreeBuffer        
);
 

Parameters

lppAllocateBuffer

[out] Pointer to a pointer to the MAPIAllocateBuffer function. The MAPIAllocateBuffer function allocates memory.

lppAllocateMore

[out] Pointer to a pointer to the MAPIAllocateMore function. The MAPIAllocateMore function allocates additional memory for memory originally allocated with MAPIAllocateBuffer.

lppFreeBuffer

[out] Pointer to a pointer to the MAPIFreeBuffer function. The MAPIFreeBuffer function frees memory.

Return Values

S_OK

The function addresses were successfully returned.

Remarks

The IMAPISupport::GetMemAllocRoutines method is implemented for all support objects. Service providers call GetMemAllocRoutines to get the addresses of the three memory allocation functions passed to their initialization function: ABProviderInit, MSProviderInit, or XPProviderInit.

See Also

MAPIAllocateBuffer, MAPIAllocateMore, MAPIFreeBuffer