Función GetEnvironmentStrings (processenv.h)

Recupera las variables de entorno para el proceso actual.

Sintaxis

LPCH GetEnvironmentStrings();

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero al bloque de entorno del proceso actual.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

La función GetEnvironmentStrings devuelve un puntero a un bloque de memoria que contiene las variables de entorno del proceso de llamada (tanto el sistema como las variables de entorno de usuario).

Cada bloque de entorno contiene las variables de entorno con el formato siguiente:

Var1=Valor1\0
Var2=Valor2\0
Var3=Valor3\0
...
Varn=ValueN\0\0

El nombre de una variable de entorno no puede incluir un signo igual (=).

Trate esta memoria como de solo lectura; no lo modifique directamente. Para agregar o cambiar una variable de entorno, use las funciones GetEnvironmentVariable y SetEnvironmentVariable .

Cuando el bloque devuelto por GetEnvironmentStrings ya no es necesario, debe liberarse llamando a la función FreeEnvironmentStrings .

Tenga en cuenta que la versión ANSI de esta función, GetEnvironmentStringsA, devuelve caracteres OEM.

Ejemplos

Para obtener un ejemplo, consulte Cambio de variables de entorno.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado processenv.h (incluya Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Variables de entorno

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable