getEnvironmentStrings 函数 (processenv.h)

检索当前进程的环境变量。

语法

LPCH GetEnvironmentStrings();

返回值

如果函数成功,则返回值是指向当前进程的环境块的指针。

如果函数失败,则返回值为 NULL。

注解

GetEnvironmentStrings 函数返回指向内存块的指针,该内存块包含调用进程的环境变量 (系统和用户环境变量) 。

每个环境块包含以下格式的环境变量:

Var1=Value1\0
Var2=Value2\0
Var3=Value3\0
...
VarN=ValueN\0\0

环境变量的名称不能包含等号 (=) 。

将此内存视为只读内存;不要直接修改它。 若要添加或更改环境变量,请使用 GetEnvironmentVariableSetEnvironmentVariable 函数。

当不再需要 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

另请参阅

环境变量

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable