Функция CreateEnvironmentBlock (userenv.h)

Статья
15.03.2023

Извлекает переменные среды для указанного пользователя. Затем этот блок можно передать в функцию CreateProcessAsUser .

Синтаксис

C++

BOOL CreateEnvironmentBlock(
  [out]          LPVOID *lpEnvironment,
  [in, optional] HANDLE hToken,
  [in]           BOOL   bInherit
);

Параметры

[out] lpEnvironment

Тип: LPVOID*

При возврате этой функции получает указатель на новый блок среды. Блок среды представляет собой массив строк Юникода, завершаемых null. Список заканчивается двумя значениями NULL (\0\0).

[in, optional] hToken

Тип: HANDLE

Маркер для пользователя, возвращенный функцией LogonUser . Если это основной маркер, он должен иметь TOKEN_QUERY и TOKEN_DUPLICATE доступ. Если маркер является маркером олицетворения, он должен иметь TOKEN_QUERY доступ. Дополнительные сведения см. в разделе Права доступа к объектам Access-Token.

Если этот параметр имеет значение NULL, возвращаемый блок среды содержит только системные переменные.

[in] bInherit

Тип: BOOL

Указывает, следует ли наследовать среду текущего процесса. Если это значение равно TRUE, процесс наследует среду текущего процесса. Если это значение равно FALSE, процесс не наследует среду текущего процесса.

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

Тип: BOOL

Значение TRUE в случае успешного выполнения; в противном случае — FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Если блок среды передается в CreateProcessAsUser, необходимо также указать флаг CREATE_UNICODE_ENVIRONMENT . После возврата CreateProcessAsUser новый процесс будет иметь копию блока среды, и DestroyEnvironmentBlock можно безопасно вызвать.

Переменные среды для конкретного пользователя, такие как %USERPROFILE%, задаются только при загрузке профиля пользователя. Чтобы загрузить профиль пользователя, вызовите функцию LoadUserProfile .

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	userenv.h
Библиотека	Userenv.lib
DLL	Userenv.dll