Функция WlxStartApplication (winwlx.h)

  • Статья

[Функция WlxStartApplication больше не доступна для использования в Windows Server 2008 и Windows Vista.]

Функция WlxStartApplication может быть реализована с помощью библиотеки DLL GINA . Winlogon вызывает эту функцию, когда системе требуется запустить приложение в контексте пользователя.

Существует две причины, по которым системе может потребоваться приложение для запуска в контексте пользователя.

  • Windows Обозреватель неожиданно завершает работу, и ее необходимо перезапустить.
  • Необходимо запустить расширенный диспетчер задач.
Примечание Библиотеки DLL GINA игнорируются в Windows Vista.
 
GINA может переопределить это поведение с помощью функции WlxStartApplication .

Синтаксис

BOOL WlxStartApplication(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PVOID pEnvironment,
  [in] PWSTR pszCmdLine
);

Параметры

[in] pWlxContext

Указатель на контекст GINA, связанный с этой станцией окон. GINA возвращает это контекстное значение, когда Winlogon вызывает WlxInitialize для этой станции.

[in] pszDesktopName

Указывает имя рабочего стола, на котором запускается приложение. Передайте эту строку в функцию CreateProcess или CreateProcessAsUser через член lpDesktop структуры STARTUPINFO .

[in] pEnvironment

Указывает начальную среду для процесса. Winlogon создает эту среду и передает ее GINA. GINA может изменить эту среду, прежде чем использовать ее для инициализации оболочки пользователя. Когда GINA завершит использование этой среды, он должен освободить память, выделенную для pEnvironment , вызвав функцию VirtualFree .

[in] pszCmdLine

Программа для выполнения.

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

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

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

Комментарии

Перед вызовом WlxStartApplication Winlogon устанавливает состояние рабочего стола таким образом, чтобы текущий рабочий стол был рабочим столом Winlogon, а состояние рабочей станции — так, чтобы рабочий стол был заблокирован.

Если функция WlxStartApplication не экспортируется GINA, Winlogon выполнит процесс.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winwlx.h

См. также раздел

WlxInitialize