Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_putenv, _wputenv

Crea, modifica o quita variables de entorno. Hay disponibles versiones más seguras de estas funciones; vea _putenv_s, _wputenv_s.

Nota importante Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas con /ZW.

int _putenv(
   const char *envstring 
);
int _wputenv(
   const wchar_t *envstring 
);

envstring

Definición de cadena de entorno.

Devuelve 0 si se ejecuta correctamente o – 1 si se produce un error.

La función _putenv agrega nuevas variables de entorno o modifica los valores de las existentes. Las variables de entorno definen el entorno en el que se ejecuta un proceso (por ejemplo, la ruta de búsqueda predeterminada para vincular bibliotecas a un programa). _wputenv es una versión con caracteres anchos de _putenv; el argumento envstring para _wputenv es una cadena de caracteres anchos.

Asignaciones de rutina de texto genérico

Rutina Tchar.h

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tputenv

_putenv

_putenv

_wputenv

El argumento envstring debe ser un puntero a una cadena con el formato varname=string, donde varname es el nombre de la variable de entorno que se va a agregar o modificar y string es el valor de la variable. Si varname ya forma parte del entorno, su valor se sustituye por string; si no es así, la nueva variable de varname y su valor de string se agregan al entorno. Una variable se puede quitar del entorno especificando un parámetro string vacío, es decir, especificando únicamente varname=.

_putenv y _wputenv solo afectan al entorno que es local en el proceso actual. No se pueden usar para modificar el entorno del nivel de comandos. Dicho de otro modo, estas funciones solo funcionan en estructuras de datos a las que puede tener acceso la biblioteca en tiempo de ejecución y no en el segmento de entorno creado para un proceso por el sistema operativo. Cuando finaliza el proceso actual, el entorno vuelve al nivel del proceso de llamada (en la mayoría de los casos, el nivel del sistema operativo). Sin embargo, el entorno modificado se puede pasar a cualquier proceso nuevo creado por _spawn, _exec o system. Estos nuevos procesos obtienen los elementos nuevos agregados por _putenv y _wputenv.

No cambie una entrada de entorno directamente: en lugar de ello, use _putenv o _wputenv para cambiarla. Especialmente, la liberación directa de elementos de la matriz global _environ[] podría dar lugar a que se obtenga acceso a memoria no válida.

getenv y _putenv usan la variable global _environ para obtener acceso a la tabla de entorno. _wgetenv y _wputenv usan _wenviron. _putenv y _wputenv podrían cambiar el valor de _environ y _wenviron, e invalidar así el argumento _envp para main y el argumento wenvp para wmain. Por ello, es más seguro usar _environ o _wenviron para obtener acceso a la información del entorno. Para obtener más información sobre la relación de _putenv y _wputenv con las variables globales, vea _environ, _wenviron.

Nota Nota

Los grupos de funciones de _putenv y _getenv no son seguros para subprocesos. _getenv podría devolver un puntero de cadena mientras _putenv modifica la cadena, y se generarían errores aleatorios. Asegúrese de que las llamadas a estas funciones están sincronizadas.

Rutina

Encabezado necesario

_putenv

<stdlib.h>

_wputenv

<stdlib.h> o <wchar.h>

Para obtener más información sobre compatibilidad, vea Compatibilidad.

Para obtener un ejemplo de cómo usar _putenv, vea getenv, _wgetenv.

No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft