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

Статья
11/20/2024

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

Синтаксис

BOOL FreeEnvironmentStringsA(
  LPCH penv
);

Параметры

penv

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

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

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

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

Замечания

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

Примеры

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2003 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	processenv.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

переменных среды

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