getEnvironmentStrings 函数 (processenv.h)
检索当前进程的环境变量。
语法
LPCH GetEnvironmentStrings();
返回值
如果函数成功,则返回值是指向当前进程的环境块的指针。
如果函数失败,则返回值为 NULL。
注解
GetEnvironmentStrings 函数返回指向内存块的指针,该内存块包含调用进程的环境变量 (系统和用户环境变量) 。
每个环境块包含以下格式的环境变量:
Var1=Value1\0
Var2=Value2\0
Var3=Value3\0
...
VarN=ValueN\0\0
环境变量的名称不能包含等号 (=) 。
将此内存视为只读内存;不要直接修改它。 若要添加或更改环境变量,请使用 GetEnvironmentVariable 和 SetEnvironmentVariable 函数。
当不再需要 GetEnvironmentStrings 返回的块时,应通过调用 FreeEnvironmentStrings 函数来释放该块。
请注意,此函数的 ANSI 版本 GetEnvironmentStringsA 返回 OEM 字符。
示例
有关示例,请参阅 更改环境变量。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | processenv.h (包括 Windows Server 2003 上的 Windows.h、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2) |
Library | Kernel32.lib |
DLL | Kernel32.dll |