Section courante

A propos

Section administrative du site

GetEnvironmentVariableA

kernel32.dll Demande la variable d'environnement
 

Syntaxe

DWORD GetEnvironmentVariableA(LPCTSTR lpName, LPTSTR lpBuffer, DWORD nSize);

Paramètres

Nom Description
lpName Ce paramètre permet d'indiquer l'adresse d'une chaîne de caractères ASCIZ du nom de la variable d'environnement. Voici les variables les plus communes :
Variable Description Portabilité
"ALLUSERSPROFILE" Cette variable permet d'indiquer le répertoire où est situé le profile utilisateur pour tous les utilisateurs Windows NT
"APPDATA" Cette variable permet d'indiquer le répertoire où sont situés les données d'application de l'utilisateur courant Windows NT
"BLASTER" Cette variable permet d'indiquer les paramètres de la carte de son de type «SoundBlaster» Application
"CFGFILE" Cette variable permet d'indiquer l'emplacement du fichier de configuration du système d'exploitation. FreeDOS
"CLASSPATH" Cette variable permet d'indiquer le répertoire de recherche pour le Java. Application Java
"CommonProgramFiles" Cette variable permet d'indiquer le répertoire où sont situés les fichiers communs d'application Windows NT
"COMPUTERNAME" Cette variable permet d'indiquer le nom de l'ordinateur Windows NT
"COMSPEC" Cette variable permet d'indiquer le nom de l'interpréteur de commande DOS, OS/2, Windows
"CONFIG" Cette variable permet d'indiquer le nom de la configuration lors du démarrage du système d'exploitation. FreeDOS, MS-DOS
"DIRCMD" Cette variable permet d'indiquer les paramètres par défaut de la commande «DIR» de l'interpréteur de commande DOS, OS/2, Windows
"DOSDIR" Cette variable permet d'indiquer le répertoire du système d'exploitation DOS. FreeDOS
"HELPPATH" Cette variable permet d'indiquer le répertoire d'aide du système d'exploitation. FreeDOS
"HOMEDRIVE" Cette variable permet d'indiquer l'unité de disque de l'utilisateur courant Windows NT
"HOMEPATH" Cette variable permet d'indiquer le répertoire de l'utilisateur courant Windows NT
"LANG" Cette variable permet d'indiquer les MID de langue courante du système d'exploitation (FR=Français, EN=anglais,...) FreeDOS
"LOGONSERVER" Cette variable permet d'indiquer le chemin réseau pour se connecter au serveur Windows NT
"MALTE" Cette variable permet d'indiquer le répertoire racine de le progiciel MonsterBook Application
"NLSPATH" Cette variable permet d'indiquer le répertoire de configuration international du système d'exploitation. FreeDOS
"NUMBER_OF_PROCESSORS" Cette variable permet d'indiquer le nombre de microprocesseur détecté sur la machine Windows NT
"OS" Cette variable permet d'indiquer le nom du système d'exploitation Windows NT
"PATH" Cette variable permet d'indiquer le répertoire de recherche pour les applications du système d'exploitation DOS, OS/2, Windows
"PATHEXT" Cette variable permet d'indiquer les extensions exécutable sur le système d'exploitation. Ils sont séparé par des points-virgule (;). Windows NT
"PROCESSOR_ARCHITECTURE" Cette variable permet d'indiquer le type de microprocesseur fonctionnant sur la machine. Windows NT
"PROCESSOR_IDENTIFIER" Cette variable permet d'indiquer l'identificateur de microprocesseur fonctionnant sur la machine. Windows NT
"PROCESSOR_LEVEL" Cette variable permet d'indiquer le niveau de génération du microprocesseur fonctionnant sur la machine. Windows NT
"PROCESSOR_REVISION" Cette variable permet d'indiquer le numéro de révision du microprocesseur fonctionnant sur la machine. Windows NT
"ProgramFiles" Cette variable permet d'indiquer le répertoire où sont situé les applications installé avec ce système d'exploitation Windows NT
"PROMPT" Cette variable permet d'indiquer l'aspect d'affichage du prompt de l'interpréteur de commande DOS, OS/2, Windows
"QTJAVA" Cette variable permet d'indiquer le répertoire de recherche pour le QuickTime avec Java. Application Java
"SESSIONNAME" Cette variable permet d'indiquer le nom de session en cours. Windows NT
"SystemDrive" Cette variable permet d'indiquer l'unité de disque du système d'exploitation. Windows NT
"SystemRoot" Cette variable permet d'indiquer le répertoire racine du système d'exploitation. Windows NT
"TEMP" Cette variable permet d'indiquer le répertoire pour les données temporaire d'application DOS, OS/2, Windows
"TMP" Cette variable permet d'indiquer le répertoire pour les données temporaire d'application DOS, OS/2, Windows
"USERDOMAIN" Cette variable permet d'indiquer le nom de domaine de l'utilisateur courant. Windows NT
"USERNAME" Cette variable permet d'indiquer le nom de l'utilisateur courant. Windows NT
"USERPROFILE" Cette variable permet d'indiquer le chemin où est situé le profile de l'utilisateur courant. Windows NT
"WATTCP.CFG" Cette variable permet d'indiquer le répertoire d'emplacement du fichier de configuration du Watcom C++ Application
"WINDIR" Cette variable permet d'indiquer le répertoire racine de Windows OS/2, Windows
... ... ...
lpBuffer Ce paramètre permet d'indiquer l'adresse d'un tampon recevant la valeur de variable d'environnement spécifié par le paramètre «lpName».
nSize Ce paramètre permet d'indiquer la taille, en caractère, du tampon recevant les données indiqué par la variable de paramètre «lpBuffer».

Description

Cette fonction permet de demander la valeur d'une variable d'environnement du système d'exploitation.

Exemple

Voici un exemple retournant le contenu de la variable d'environnement «PATH» du système d'exploitation à l'aide d'un code source avec un compilateur «MinGW» :

  1. #include <stdio.h>
  2. #include <stdlib.h>
  3. #include <windows.h>
  4.  
  5. int main()
  6. {
  7.     char buffer[1024];
  8.     DWORD ret_size = GetEnvironmentVariableA("PATH", buffer, sizeof(buffer));
  9.     printf("La variable d'environnement PATH contient : %s",buffer);
  10.     return 0;
  11. }

on obtiendra le résultat ressemblant à celui-ci sous «Windows XP Professionnel»:

La variable d'environnement PATH contient : .;D:\Program Files\CodeBlocks\MinGW\
bin;D:\Perl\bin\;D:\GNAT\2008\bin;D:\LANGAGE\GNAT\2007\bin;D:\LANGAGE\GNAT\2007\
libexec\gcc\pentium-mingw32msv\4.1.3;D:\GNAT\bin;D:\Program Files\Mercury Intera
ctive\LoadRunner\bin;D:\Program Files\Fichiers communs\Mercury Interactive\Share
dFiles\bin;D:\WINDOWS\system32;D:\WINDOWS;D:\WINDOWS\System32\Wbem;D:\Program Fi
les\Fichiers communs\Ulead Systems\MPEG;D:\WINDOWS\system32\WindowsPowerShell\v1
.0;D:\Program Files\QuickTime\QTSystem\;D:\Tcl\bin;;%PATH%;D:\LANGAGE\FPC\2.2.0\
bin\i386-Win32;D:\Program Files\gfortran\libexec\gcc\i386-pc-mingw32\4.3.0;D:\Pr
ogram Files\gfortran\bin;D:\Program Files\Druide\Antidote;C:\PROGRA~1\BC5\BIN;C:
\WINMEFRA;C:\WINMEFRA\COMMAND

Voir également

Langage de programmation - C pour Windows - API de Windows - GetEnvironmentStringsA
Langage de programmation - C pour Windows - API de Windows - SetEnvironmentVariableA

Références

Delphi 3.0 Professionnel, Borland, 1996, CD-ROM, les fichiers d'aide : «WIN32.HLP»

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