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 |