FreeEnvironmentStringsA 函数 (processenv.h)

释放环境字符串块。

语法

BOOL FreeEnvironmentStringsA(
  LPCH penv
);

参数

penv

指向环境字符串块的指针。 必须通过调用 GetEnvironmentStrings 函数来获取指向块的指针。

返回值

如果函数成功,则返回值为非零。

如果函数失败,则返回值为零 若要获取扩展错误信息,请调用 GetLastError

言论

如果使用了 GetEnvironmentStrings 函数的 ANSI 版本,请务必使用 FreeEnvironmentStrings的 ANSI 版本。 同样,如果使用了 GetEnvironmentStrings的 Unicode 版本,请务必使用 FreeEnvironmentStrings的 Unicode 版本。

例子

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

注意

processenv.h 标头将 FreeEnvironmentStrings 定义为别名,该别名根据 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

另请参阅

环境变量