GetEnvironmentStrings, fonction (processenv.h)
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 |