Fonction FreeEnvironmentStringsA (processenv.h)
Libère un bloc de chaînes d’environnement.
Syntaxe
BOOL FreeEnvironmentStringsA(
LPCH penv
);
Paramètres
penv
Pointeur vers un bloc de chaînes d’environnement. Le pointeur vers le bloc doit être obtenu en appelant la fonction GetEnvironmentStrings .
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est zéro Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Si vous avez utilisé la version ANSI de GetEnvironmentStrings, veillez à utiliser la version ANSI de FreeEnvironmentStrings. De même, si vous avez utilisé la version Unicode de GetEnvironmentStrings, veillez à utiliser la version Unicode de FreeEnvironmentStrings.
Exemples
Pour obtenir un exemple, consultez Modification des variables d’environnement.
Notes
L’en-tête processenv.h définit FreeEnvironmentStrings comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
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 |