GetEnvironmentStrings, fonction (processenv.h)

  • Article

Récupère les variables d’environnement pour le processus actuel.

Syntaxe

LPCH GetEnvironmentStrings();

Valeur de retour

Si la fonction réussit, la valeur de retour est un pointeur vers le bloc d’environnement du processus actuel.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

La fonction GetEnvironmentStrings retourne un pointeur vers un bloc de mémoire qui contient les variables d’environnement du processus appelant (variables d’environnement système et utilisateur).

Chaque bloc d’environnement contient les variables d’environnement au format suivant :

Var1=Valeur1\0
Var2=Valeur2\0
Var3=Valeur3\0
...
Varn=ValueN\0\0

Le nom d’une variable d’environnement ne peut pas inclure un signe égal (=).

Traitez cette mémoire en lecture seule ; ne le modifiez pas directement. Pour ajouter ou modifier une variable d’environnement, utilisez les fonctions GetEnvironmentVariable et SetEnvironmentVariable .

Lorsque le bloc retourné par GetEnvironmentStrings n’est plus nécessaire, il doit être libéré en appelant la fonction FreeEnvironmentStrings .

Notez que la version ANSI de cette fonction, GetEnvironmentStringsA, retourne des caractères OEM.

Exemples

Pour obtenir un exemple, consultez Modification des variables d’environnement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête processenv.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

Variables d’environnement

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable