FreeEnvironmentStringsA 函数 (processenv.h)

释放环境字符串块。

语法

BOOL FreeEnvironmentStringsA(
  LPCH penv
);

参数

penv

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

返回值

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

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

注解

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

示例

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

注意

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

要求

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

另请参阅

环境变量

GetEnvironmentStrings