MAPIAllocateBuffer
Hace referencia a: Outlook 2013 | Outlook 2016
Asigna un búfer de memoria.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapix.h |
| Implementado por: |
MAPI |
| Llamado por: |
Aplicaciones cliente y proveedores de servicios |
SCODE MAPIAllocateBuffer(
ULONG cbSize,
LPVOID FAR * lppBuffer
);
Parameters
cbSize
[in] Tamaño, en bytes, del búfer que se va a asignar.
lppBuffer
[out] Puntero al búfer asignado devuelto.
Valor devuelto
S_OK
La llamada se realizó correctamente y ha devuelto el búfer de memoria solicitado.
Comentarios
Durante el procesamiento de llamadas MAPIAllocateBuffer , la implementación de llamada adquiere un bloque de memoria del sistema operativo. El búfer de memoria se asigna en una dirección de bytes numerada uniformemente. En las plataformas en las que el acceso de enteros largos es más eficaz, el sistema operativo asigna el búfer a una dirección cuyo tamaño en bytes es un múltiplo de cuatro.
Al llamar a la función MAPIFreeBuffer , se libera el búfer de memoria asignado por MAPIAllocateBuffer, llamando a la función MAPIAllocateMore y a los búferes vinculados a él, cuando ya no se necesita la memoria.