Compartilhar via


MAPIAllocateBuffer

Windows Mobile SupportedWindows Embedded CE Not Supported

9/8/2008

The MAPIAllocateBuffer função aloca uma reserva memória.

Syntax

SCODE MAPIAllocateBuffer(
  ULONG cbSize, 
  LPVOID FAR* lppBuffer 
);

Parameters

  • cbSize
    [no] Tamanho, em bytes, da reserva a ser alocada.
  • lppBuffer
    [out] Ponteiro para o retornado alocado reserva.

Return Value

  • S_OK
    O chamar bem-sucedida e foi retornado o valor esperado ou valores.

Remarks

Durante MAPIAllocateBuffer chamar processamento, a implementação chamado adquire um bloco de memória a partir de sistema operacional. Reserva de memória é alocada em um endereço even-numbered byte. Em plataformas onde acessar inteiro longo é mais eficiente, o sistema operacional aloca a reserva em um endereço cujo tamanho em bytes é um múltiplo de quatro.

Chamando o MAPIFreeBuffer função libera a reserva memória alocada por MAPIAllocateBuffer e também libera os buffers adicionais que foram vinculados a ele por meio de MAPIAllocateMore função.

Requirements

Header mapix.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

MAPI Functions

Other Resources

Messaging