Section courante

A propos

Section administrative du site

LocalAlloc

kernel32.dll Alloue locale
Windows 9X, NT 3.1+, 2000, XP, 2003

Syntaxe

HLOCAL LocalAlloc(UINT uFlags, UINT uBytes);

Paramètres

Nom Description
uFlags Ce paramètre permet d'indiquer comment allouer de la mémoire. Si la valeur 0 est spécifiée, la valeur par défaut est le drapeau LMEM_FIXED. À l'exception des combinaisons incompatibles étant spécifiquement notées, toute combinaison des drapeaux suivants peut être spécifiée. Pour indiquer si la fonction alloue de la mémoire fixe ou mobile, spécifiez l'un des 6 premiers drapeaux :
Valeur Description
LMEM_FIXED Cette valeur permet d'allouer de la mémoire fixe. Ce drapeau ne peut pas être combiné avec les drapeaux LMEM_MOVEABLE ou LMEM_DISCARDABLE. La valeur de retour est un pointeur sur le bloc de mémoire. Pour accéder à la mémoire, le processus appelant convertit simplement la valeur de retour en un pointeur.
LMEM_MOVEABLE Cette valeur permet d'allouer de la mémoire déplaçable. Ce drapeau ne peut pas être combiné avec le drapeau LMEM_FIXED. La valeur de retour est l'identificateur de l'objet de la mémoire. Le descripteur est une quantité 32 bits privée du processus appelant. Pour convertir l'identificateur en un pointeur, utilisez la fonction LocalLock.
LPTR Cette valeur permet de combiner les drapeaux LMEM_FIXED et LMEM_ZEROINIT.
LHND Cette valeur permet de combiner les drapeaux LMEM_MOVEABLE et LMEM_ZEROINIT.
NONZEROLHND Cette valeur permet d'allouer de la mémoire déplaçable. Ce drapeau ne peut pas être combiné avec le drapeau LMEM_FIXED. La valeur de retour est l'identificateur de l'objet de la mémoire. Le descripteur est une quantité 32 bits privée du processus appelant. Pour convertir l'identificateur en un pointeur, utilisez la fonction LocalLock.
NONZEROLPTR Cette valeur permet d'allouer de la mémoire fixe. Ce drapeau ne peut pas être combiné avec les drapeaux LMEM_MOVEABLE ou LMEM_DISCARDABLE. La valeur de retour est un pointeur sur le bloc de mémoire. Pour accéder à la mémoire, le processus appelant convertit simplement la valeur de retour en un pointeur.
LMEM_DISCARDABLE Cette valeur permet d'allouer la mémoire jetable. Ce drapeau ne peut pas être combiné avec le drapeau LMEM_FIXED. Certaines applications Win32 peuvent ignorer ce drapeau.
LMEM_NOCOMPACT Cette valeur permet de ne pas compresser ou ne pas supprimer la mémoire pour satisfaire la demande d'allocation.
LMEM_NODISCARD Cette valeur permet de ne pas supprimer la mémoire pour satisfaire la demande d'allocation.
LMEM_ZEROINIT Cette valeur permet d'initialiser le contenu de la mémoire à 0.
uBytes Ce paramètre permet d'indiquer le nombre d'octets à allouer. Si ce paramètre est égal à 0 et que le paramètre uFlags spécifie le drapeau LMEM_MOVEABLE, la fonction renvoie un descripteur à un objet mémoire marqué comme étant ignoré.

Retour

Valeur Description
NULL Cette valeur permet d'indiquer que la fonction a échoué. Pour obtenir des informations d'erreur étendues, appelez la fonction GetLastError.
NULL != Ces valeurs permettent d'indiquer que l'opération a réussi et la valeur de retour est le descripteur du nouvel objet mémoire alloué.

Description

Cette fonction permet d'allouer le nombre d'octets spécifiés pour le tas local.

Remarques

Voir également

Langage de programmation - C pour Windows - API de Windows - GlobalAlloc
Langage de programmation - C pour Windows - API de Windows - LocalFree
Langage de programmation - C pour Windows - API de Windows - LocalLock
Langage de programmation - C pour Windows - API de Windows - LocalReAlloc
Langage de programmation - C pour Windows - API de Windows - LocalSize

Dernière mise à jour : Dimanche, le 6 décembre 2015