MAPIAllocateBuffer
Aplica-se a: Outlook 2013 | Outlook 2016
Aloca um buffer de memória.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapix.h |
| Implementado por: |
MAPI |
| Chamado por: |
Aplicativos cliente e provedores de serviços |
SCODE MAPIAllocateBuffer(
ULONG cbSize,
LPVOID FAR * lppBuffer
);
Parâmetros
Cbsize
[in] Tamanho, em bytes, do buffer a ser alocado.
lppBuffer
[out] Ponteiro para o buffer alocado retornado.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o buffer de memória solicitado.
Comentários
Durante o processamento de chamadas MAPIAllocateBuffer , a implementação de chamada adquire um bloco de memória do sistema operacional. O buffer de memória é alocado em um endereço de byte com numeração uniforme. Em plataformas em que o acesso inteiro longo é mais eficiente, o sistema operacional aloca o buffer em um endereço cujo tamanho em bytes é um múltiplo de quatro.
Chamar a função MAPIFreeBuffer libera o buffer de memória alocado por MAPIAllocateBuffer, chamando a função MAPIAllocateMore e quaisquer buffers vinculados a ele, quando a memória não for mais necessária.