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

  • Статья

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

Синтаксис

LPCH GetEnvironmentStrings();

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

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

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

Комментарии

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

Каждый блок среды содержит переменные среды в следующем формате:

Var1=Значение1\0
Var2=Значение2\0
Var3=Значение3\0
...
VarN=ValueN\0\0

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

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

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

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

Примеры

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

Требования

Требование Значение
Минимальная версия клиента 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

См. также

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

FreeEnvironmentStrings

GetEnvironmentVariable

SetEnvironmentVariable