MAPIAllocateMore

Aplica-se a: Outlook 2013 | Outlook 2016

Aloca um buffer de memória vinculado a outro buffer alocado anteriormente com a função MAPIAllocateBuffer .

Propriedade	Valor
Arquivo de cabeçalho:	Mapix.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de serviços

SCODE MAPIAllocateMore(
  ULONG cbSize,
  LPVOID lpObject,
  LPVOID FAR * lppBuffer
);

Parâmetros

Cbsize

[in] Tamanho, em bytes, do novo buffer a ser alocado.

lpObject

[in] Ponteiro para um buffer MAPI existente alocado usando MAPIAllocateBuffer.

lppBuffer

[out] Ponteiro para o buffer retornado e recém-alocado.

Valor de retorno

S_OK

A chamada foi bem-sucedida e retornou um ponteiro para a memória solicitada.

Comentários

Durante o processamento de chamadas MAPIAllocateMore , 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.

A única maneira de liberar um buffer alocado com MAPIAllocateMore é passar o ponteiro de buffer especificado no parâmetro lpObject para a função MAPIFreeBuffer . O link entre os buffers de memória alocados com MAPIAllocateBuffer e MAPIAllocateMore permite que MAPIFreeBuffer libere ambos os buffers com uma única chamada.