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

  • Article

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

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête objidl.h

Voir aussi

CoTaskMemAlloc

IMalloc