MAPIAllocateBuffer
S’applique à : Outlook 2013 | Outlook 2016
Alloue une mémoire tampon.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapix.h |
| Implémenté par : |
MAPI |
| Appelé par : |
Applications clientes et fournisseurs de services |
SCODE MAPIAllocateBuffer(
ULONG cbSize,
LPVOID FAR * lppBuffer
);
Paramètres
cbSize
[in] Taille, en octets, de la mémoire tampon à allouer.
lppBuffer
[out] Pointeur vers la mémoire tampon allouée retournée.
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la mémoire tampon demandée.
Remarques
Pendant le traitement des appels MAPIAllocateBuffer , 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.
L’appel de la fonction MAPIFreeBuffer libère la mémoire tampon allouée par MAPIAllocateBuffer, en appelant la fonction MAPIAllocateMore et toutes les mémoires tampons qui y sont liées, lorsque la mémoire n’est plus nécessaire.