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.