MAPIAllocateMore

S’applique à : Outlook 2013 | Outlook 2016

Alloue une mémoire tampon liée à une autre mémoire tampon précédemment allouée avec la fonction MAPIAllocateBuffer .

Propriété	Valeur
Fichier d’en-tête :	Mapix.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

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

Paramètres

cbSize

[in] Taille, en octets, de la nouvelle mémoire tampon à allouer.

lpObject

[in] Pointeur vers une mémoire tampon MAPI existante allouée à l’aide de MAPIAllocateBuffer.

lppBuffer

[out] Pointeur vers la mémoire tampon retournée et nouvellement allouée.

Valeur renvoyée

S_OK

L’appel a réussi et a retourné un pointeur vers la mémoire demandée.

Remarques

Pendant le traitement des appels MAPIAllocateMore , l’implémentation appelante acquiert un bloc de mémoire à partir du système d’exploitation. La mémoire tampon est allouée sur une adresse d’octet paire. Sur les plateformes où l’accès aux entiers longs est plus efficace, le système d’exploitation alloue la mémoire tampon sur une adresse dont la taille en octets est un multiple de quatre.

La seule façon de libérer une mémoire tampon allouée avec MAPIAllocateMore consiste à passer le pointeur de mémoire tampon spécifié dans le paramètre lpObject à la fonction MAPIFreeBuffer . Le lien entre les mémoires tampons allouées avec MAPIAllocateBuffer et MAPIAllocateMore permet à MAPIFreeBuffer de libérer les deux mémoires tampons avec un seul appel.