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» :
- #include <stdio.h>
- #include <stdlib.h>
- #include <windows.h>
-
- int main()
- {
- char buffer[1024];
- DWORD ret_size = GetEnvironmentVariableA("PATH", buffer, sizeof(buffer));
- printf("La variable d'environnement PATH contient : %s",buffer);
- return 0;
- }
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