.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH MAPIAllocateBuffer 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBMAPIAllocateBuffer\fR (MAPI32.12)
.SH SYNOPSIS
SCODE MAPIAllocateBuffer
 (
  ULONG   \fIcbSize\fR,
  LPVOID* \fIlppBuffer\fR
 )

.SH DESCRIPTION
.PP
MAPIAllocateBuffer@8 (\fBMAPI32\fR.\fB13\fR). 
.PP
Allocate a block of memory. 

.SH PARAMS
\fIcbSize\fR \fB[In]\fR  Size of the block to allocate in bytes.
.PP
\fIlppBuffer\fR \fB[Out]\fR  Destination for pointer to allocated memory.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBS_OK\fR. *\fIlppBuffer\fR is filled with a pointer to a memory block of length \fIcbSize\fR bytes. 
.PP
\fBFailure:\fR \fBMAPI_E_INVALID_PARAMETER\fR, if \fIlppBuffer\fR is \fBNULL\fR. \fBMAPI_E_NOT_ENOUGH_MEMORY\fR, if the memory allocation fails. 

.SH NOTES
.PP
Memory allocated with this function should be freed with \fBMAPIFreeBuffer(3w)\fR. Further allocations of memory may be linked to the pointer returned using MAPIAllocateMore(). Linked allocations are freed when the initial pointer is feed. 

.SH IMPLEMENTATION
.PP
Declared in \fB"util.h"\fR. 
.PP
Implemented in \fB"dlls/mapi32/util.c"\fR. 
.PP
Debug channel \fB"mapi"\fR.