Поделиться через


Функция FreeEnvironmentStringsA (processenv.h)

Освобождает блок строк среды.

Синтаксис

BOOL FreeEnvironmentStringsA(
  LPCH penv
);

Параметры

penv

Указатель на блок строк среды. Указатель на блок необходимо получить путем вызова функции GetEnvironmentStrings .

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция завершается сбоем, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Если вы использовали версию ANSI GetEnvironmentStrings, обязательно используйте версию ANSI FreeEnvironmentStrings. Аналогичным образом, если вы использовали версию GetEnvironmentStrings в Юникоде, обязательно используйте версию FreeEnvironmentStrings в Юникоде.

Примеры

Пример см. в разделе Изменение переменных среды.

Примечание

Заголовок processenv.h определяет FreeEnvironmentStrings в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header processenv.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

Переменные среды

GetEnvironmentStrings