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