Freigeben über


MAPIAllocateBuffer

Gilt für: Outlook 2013 | Outlook 2016

Ordnet einen Speicherpuffer zu.

Eigenschaft Wert
Headerdatei
Mapix.h
Implementiert von:
MAPI
Aufgerufen von:
Clientanwendungen und Dienstanbieter
SCODE MAPIAllocateBuffer(
  ULONG cbSize,
  LPVOID FAR * lppBuffer
);

Parameter

cbSize

[in] Größe des zuzuordnenden Puffers in Bytes.

lppBuffer

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

Rückgabewert

S_OK

Der Aufruf war erfolgreich und hat den angeforderten Speicherpuffer zurückgegeben.

Hinweise

Während der MAPIAllocateBuffer-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.

Beim Aufrufen der MAPIFreeBuffer-Funktion wird der von MAPIAllocateBuffer zugewiesene Speicherpuffer freigegeben, indem die MAPIAllocateMore-Funktion und alle damit verknüpften Puffer aufgerufen werden, wenn der Arbeitsspeicher nicht mehr benötigt wird.

Siehe auch

MAPIReallocateBuffer