Функция GetEnvironmentStrings

Функция GetEnvironmentStrings извлекает переменные окружения для текущего процесса. Эта функция заменяет функцию GetDOSEnvironment.

Синтаксис

LPVOID GetEnvironmentStrings(VOID)

Параметры

У этой функции нет параметров.

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

Величина возвращаемого значения - указатель на блок конфигурации для текущего процесса.

Замечания

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

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

Windows 95/98/Me: Функция GetEnvironmentStringsW поддерживается подпрограммой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в требованиях этой подпрограммы для систем Windows 95/98/Me.

Код примера

Пример смотри в статье Изменение переменных окружения.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, CreateProcess, GetEnvironmentVariable, SetEnvironmentVariable, FreeEnvironmentStrings

Размещение и совместимость GetEnvironmentStrings

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Реализуется как версии Unicode и ANSI в Windows NT /2000/XP.

Поддерживается также подпрограммой Microsoft Layer for Unicode

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz