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

Статья
03/08/2023

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

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

Примечание Библиотеки DLL GINA игнорируются в Windows Vista.

Контекст, возвращаемый этой функцией, будет передаваться обратно в GINA во всех последующих вызовах.

Синтаксис

BOOL WlxInitialize(
  [in]  LPWSTR lpWinsta,
  [in]  HANDLE hWlx,
  [in]  PVOID  pvReserved,
  [in]  PVOID  pWinlogonFunctions,
  [out] PVOID  *pWlxContext
);

Параметры

[in] lpWinsta

Указатель на имя инициализируемого окна.

[in] hWlx

Дескриптор Winlogon. GINA должен предоставлять этот дескриптор во всех вызовах функций поддержки Winlogon, которые используют эту оконную станцию.

[in] pvReserved

Этот параметр зарезервирован для использования в будущем и должен иметь значение NULL.

[in] pWinlogonFunctions

Указатель на таблицу диспетчеризации функций поддержки Winlogon. Содержимое таблицы зависит от версии библиотеки DLL GINA, возвращенной вызовом WlxNegotiate . Эта таблица не изменяется, что позволяет библиотеке DLL GINA ссылаться на таблицу, не копируя ее. Если библиотеке DLL GINA необходимо создать копию таблицы, она должна вызвать WlxGetOption и предоставить WLX_OPTION_DISPATCH_TABLE_SIZE для параметра Option .

Значение	Значение
WLX_DISPATCH_VERSION_1_4	Таблица диспетчеризации Winlogon — версия 1.4
WLX_DISPATCH_VERSION_1_3	Таблица диспетчеризации Winlogon — версия 1.3
WLX_DISPATCH_VERSION_1_2	Таблица диспетчеризации Winlogon — версия 1.2
WLX_DISPATCH_VERSION_1_1	Таблица Winlogondispatch — версия 1.1
WLX_DISPATCH_VERSION_1_0	Таблица диспетчеризации Winlogon — версия 1.0

[out] pWlxContext

Указатель на указатель на VOID , который будет содержать адрес контекста GINA для этой оконной станции. Этот контекст передается во всех последующих вызовах GINA из Winlogon. Библиотека DLL GINA управляет любой памятью, используемой контекстом. Указатель контекста можно изменить позже, вызвав функцию WlxSetOption с WLX_OPTION_CONTEXT_POINTER.

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

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

Если функция завершается сбоем или если библиотека DLL GINA не была инициализирована, функция возвращает значение FALSE. Winlogon завершит работу, и система не будет загружаться.

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

Требования

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

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

WlxNegotiate