Méthode IMalloc ::Alloc (objidl.h)

Alloue un bloc de mémoire.

Syntaxe

void * Alloc(
  [in] SIZE_T cb
);

Paramètres

[in] cb

Taille du bloc de mémoire à allouer, en octets.

Valeur retournée

Si la méthode réussit, la valeur de retour est un pointeur vers le bloc de mémoire alloué. Sinon, elle est NULL.

Les applications doivent toujours case activée la valeur de retour de cette méthode, même lorsqu’elles demandent de petites quantités de mémoire, car il n’y a aucune garantie que la mémoire sera allouée.

Remarques

Le contenu initial du bloc de mémoire retourné n’est pas défini et il n’y a aucune garantie que le bloc a été initialisé. Vous devez donc l’initialiser dans votre code. Le bloc alloué peut être supérieur à cb octets en raison de l’espace nécessaire à l’alignement et aux informations de maintenance.

Si cb a la valeur zéro, Alloc alloue un élément de longueur zéro et retourne un pointeur valide vers cet élément. S’il n’y a pas suffisamment de mémoire disponible, Alloc retourne NULL.

Configuration requise

Voir aussi

CoTaskMemAlloc

IMalloc