GetEnvironmentStringsW 函数 (processenv.h)

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

语法

LPWCH GetEnvironmentStringsW();

返回值

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

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

言论

GetEnvironmentStrings 函数返回一个指针,该内存块包含调用进程的环境变量(系统和用户环境变量)。 每个环境块包含以下格式的环境变量:

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

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

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

不再需要 GetEnvironmentStrings 返回的块时,应通过调用 FreeEnvironmentStrings 函数释放它。

请注意,此函数的 ANSI 版本(GetEnvironmentStringsA)返回 OEM 字符。

例子

有关示例,请参阅 更改环境变量

注意

processenv.h 标头将 GetEnvironmentStrings 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2003 [桌面应用 |UWP 应用]
目标平台 窗户
标头 processenv.h (包括 Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2 上的 Windows.h)
Kernel32.lib
DLL Kernel32.dll

另请参阅

环境变量

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable