MAPIAllocateMore

Gilt für: Outlook 2013 | Outlook 2016

Ordnet einen Speicherpuffer zu, der mit einem anderen Puffer verknüpft ist, der zuvor mit der MAPIAllocateBuffer-Funktion zugeordnet wurde.

Eigenschaft	Wert
Headerdatei	Mapix.h
Implementiert von:	MAPI
Aufgerufen von:	Clientanwendungen und Dienstanbieter

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

Parameter

cbSize

[in] Größe des neuen Puffers, der zugeordnet werden soll, in Bytes.

lpObject

[in] Zeiger auf einen vorhandenen MAPI-Puffer, der mit MAPIAllocateBuffer zugeordnet wurde.

lppBuffer

[out] Zeiger auf den zurückgegebenen, neu zugeordneten Puffer.

Rückgabewert

S_OK

Der Aufruf war erfolgreich und hat einen Zeiger auf den angeforderten Arbeitsspeicher zurückgegeben.

Hinweise

Während der MAPIAllocateMore-Aufrufverarbeitung ruft die aufrufende Implementierung einen Speicherblock vom Betriebssystem ab. Der Speicherpuffer wird einer geraden Byteadresse zugeordnet. Auf Plattformen, auf denen der Zugriff auf lange Ganze Zahlen effizienter ist, weist das Betriebssystem den Puffer einer Adresse zu, deren Größe in Bytes ein Vielfaches von vier ist.

Die einzige Möglichkeit, einen mit MAPIAllocateMore zugeordneten Puffer freizugeben, besteht darin, den im lpObject-Parameter angegebenen Pufferzeiger an die MAPIFreeBuffer-Funktion zu übergeben. Die Verknüpfung zwischen den Speicherpuffern, die mit MAPIAllocateBuffer und MAPIAllocateMore zugeordnet sind, ermöglicht ES MAPIFreeBuffer , beide Puffer mit einem einzigen Aufruf freizugeben.