_putenv_s, _wputenv_s

Crée, modifie ou supprime, les variables d'environnement. Il s'agit de versions de _putenv, _wputenv avec des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.

errno_t _putenv_s(
   const char *name,
   const char *value 
);
errno_t _wputenv_s(
   const wchar_t *name,
   const wchar_t *value
);

Paramètres

• name
  Le nom d'une variable d'environnement.

• value
  La valeur à laquelle affecter la variable d'environnement.

Valeur de retour

Retourne 0 en cas de réussite, ou un code d'erreur.

Conditions d'erreur

Si l'une des conditions d'erreur se produit, elles appellent un gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent EINVAL et définissent errno avec la valeur EINVAL.

Notes

La fonction _putenv_s ajoute de nouvelles variables d'environnement ou modifie les valeurs des variables d'environnement existantes. Les variables d'environnement définissent l'environnement dans lequel un processus s'exécute (par exemple, le chemin de recherche par défaut pour relier les bibliothèques à un programme). _wputenv_s est une version à caractères larges de _putenv_s; l'argument envstring vers _wputenv_s est une chaîne à caractères larges.

Mappages de routines de texte générique

name est le nom de la variable d'environnement à ajouter ou modifier et value est la valeur de la variable. Si name fait déjà partie de l'environnement, sa valeur est remplacée par value; sinon, la nouvelle variable name et sa value sont ajoutées à l'environnement. Vous pouvez supprimer une variable de l'environnement en spécifiant une chaîne vide (autrement dit, "") pour value.

_putenv_s et _wputenv_s affectent uniquement l'environnement qui est local au processus actuel ; vous ne pouvez pas les utiliser pour modifier l'environnement de commande niveau. Ces fonctions fonctionnent uniquement sur les structures de données accessibles à la bibliothèque Runtime et non dans le "segment" d'environnement créé pour un processus par le système d'exploitation. Lorsque le processus actuel se termine, l'environnement revient au niveau du processus appelant, dans la plupart des cas, le niveau du système d'exploitation. Toutefois, l'environnement modifié peut être passé à tous les nouveaux processus créés par _spawn, _exec, ou system, et ces nouveaux processus obtiennent tous les nouveaux éléments ajoutés par _putenv_s et _wputenv_s.

Ne modifiez pas une entrée d'environnement directement : à la place, utilisez _putenv_s ou _wputenv_s pour le modifier. En particulier, la libération directe d'éléments du tableau global _environ[] pourrait mener au remplissage d'une mémoire non valide.

getenv et _putenv_s utilisent la variable globale _environ pour accéder à la table d'environnement ; _wgetenv et _wputenv_s utilisent _wenviron. _putenv_s et _wputenv_s peuvent modifier la valeur de_environ et de_wenviron, et rendent ainsi l'argument envp invalide à main et l'argument _wenvp à wmain. Par conséquent, il est préférable d'utiliser _environ ou _wenviron pour accéder aux informations d'environnement. Pour plus d'informations sur la relation de_putenv_s et de_wputenv_s avec les variables globales, consultez _environ, _wenviron.

Configuration requise

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

Exemple

Pour obtenir un exemple qui indique comment utiliser _putenv_s, consultez getenv_s, _wgetenv_s.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de code non managé.

Voir aussi

Référence

Contrôle de processus et d'environnement

getenv, _wgetenv

_searchenv, _wsearchenv