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

Извлекает переменные среды для текущего процесса.

Синтаксис

LPWCH GetEnvironmentStringsW();

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

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

Если функция завершается ошибкой, возвращаемое значение равно NULL.

Замечания

Функция GetEnvironmentStrings возвращает указатель на блок памяти, содержащий переменные среды вызывающего процесса (как системные, так и переменные пользовательской среды). Каждый блок среды содержит переменные среды в следующем формате:

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

Имя переменной среды не может содержать знак равенства (=).

Рассматривать эту память как доступную только для чтения; не изменяйте его напрямую. Чтобы добавить или изменить переменную среды, используйте функции GetEnvironmentVariable и SetEnvironmentVariable.

Если блок, возвращаемый GetEnvironmentStrings, больше не нужен, он должен быть освобожден путем вызова функции FreeEnvironmentStrings.

Обратите внимание, что версия ANSI этой функции GetEnvironmentStringsAвозвращает символы OEM.

Примеры

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

Заметка

Заголовок processenv.h определяет GetEnvironmentStrings в качестве псевдонима, который автоматически выбирает версию 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

См. также

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

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable