функция обратного вызова PWLX_SET_RETURN_DESKTOP (winwlx.h)

Статья
08/28/2023

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

Вызывается GINA , чтобы указать альтернативный рабочий стол приложения, на который winlogon будет переключаться при завершении текущей функции обработки событий sas .

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

Синтаксис

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

BOOL PwlxSetReturnDesktop(
  [in] HANDLE hWlx,
  [in] PWLX_DESKTOP pDesktop
)
{...}

Параметры

[in] hWlx

Указывает дескриптор Winlogon, передаваемый в GINA в вызове WlxInitialize .

[in] pDesktop

Указатель на сведения о рабочем столе для альтернативного рабочего стола. Этот рабочий стол создается путем вызова функции WlxCreateUserDesktop .

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

Функция WlxSetReturnDesktop возвращает одно из следующих значений.

Код возврата	Описание
TRUE	Вызов функции выполнен успешно.
FALSE	Вызов функции не смог задать возвращаемый рабочий стол.

Если указан дескриптор рабочего стола, Winlogon будет дублировать дескриптор. Если дескриптор не указан, Winlogon попытается открыть рабочий стол с именем в параметре pDesktop . Если предоставленный рабочий стол является недопустимым или является рабочим столом Winlogon или заставки, вызов завершится ошибкой.

Требования


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

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