CoTaskMemAlloc, fonction (combaseapi.h)

  • Article

Alloc alloue un bloc de mémoire de tâche de la même manière que IMalloc ::Alloc .

Syntaxe

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

Paramètres

[in] cb

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

Valeur retournée

Si la fonction réussit, elle retourne le bloc de mémoire alloué. Dans le cas contraire, elle retourne LA VALEUR NULL.

Remarques

CoTaskMemAlloc utilise l’répartiteur par défaut pour allouer un bloc de mémoire de la même manière que IMalloc ::Alloc . Il n’est pas nécessaire d’appeler la fonction CoGetMalloc avant d’appeler CoTaskMemAlloc.

Le contenu initial du bloc de mémoire retourné n’est pas défini. Il n’est pas garanti que le bloc a été initialisé. 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 0, CoTaskMemAlloc alloue un élément de longueur nulle et retourne un pointeur valide vers cet élément. Si la mémoire disponible est insuffisante, CoTaskMemAlloc retourne NULL. Les applications doivent toujours case activée la valeur de retour de cette fonction, 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête combaseapi.h (inclure Objbase.h)
Bibliothèque Ole32.lib
DLL Ole32.dll

Voir aussi

CoTaskMemFree

CoTaskMemRealloc

IMalloc ::Alloc