MAPIAllocateMore

Hace referencia a: Outlook 2013 | Outlook 2016

Asigna un búfer de memoria vinculado a otro búfer asignado anteriormente con la función MAPIAllocateBuffer .

Propiedad	Valor
Archivo de encabezado:	Mapix.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

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

Parameters

cbSize

[in] Tamaño, en bytes, del nuevo búfer que se va a asignar.

lpObject

[in] Puntero a un búfer MAPI existente asignado mediante MAPIAllocateBuffer.

lppBuffer

[out] Puntero al búfer devuelto recién asignado.

Valor devuelto

S_OK

La llamada se realizó correctamente y devolvió un puntero a la memoria solicitada.

Comentarios

Durante el procesamiento de llamadas MAPIAllocateMore , 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.

La única manera de liberar un búfer asignado con MAPIAllocateMore es pasar el puntero de búfer especificado en el parámetro lpObject a la función MAPIFreeBuffer . El vínculo entre los búferes de memoria asignados con MAPIAllocateBuffer y MAPIAllocateMore permite a MAPIFreeBuffer liberar ambos búferes con una sola llamada.