Función GetEnvironmentStringsW (processenv.h)
Recupera las variables de entorno para el proceso actual.
Sintaxis
LPWCH GetEnvironmentStringsW();
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un puntero al bloque de entorno del proceso actual.
Si se produce un error en la función, el valor devuelto es NULL.
Observaciones
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=Value1\0
Var2=Value2\0
Var3=Value3\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 la
Cuando el bloque devuelto por GetEnvironmentStrings ya no es necesario, debe liberarse llamando a la función FreeEnvironmentString s.
Tenga en cuenta que la versión ANSI de esta función, GetEnvironmentStringsA, devuelve caracteres OEM.
Ejemplos
Para obtener un ejemplo, vea Cambiar variables de entorno.
Nota
El encabezado processenv.h define GetEnvironmentStrings como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [aplicaciones de escritorio | Aplicaciones para UWP] |
| servidor mínimo admitido | Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP] |
| de la plataforma de destino de |
Windows |
| encabezado de |
processenv.h (incluya Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |
Consulte también
variables de entorno de