функция обратного вызова PWLX_SET_RETURN_DESKTOP (winwlx.h)
[Функция WlxSetReturnDesktop больше не доступна для использования в Windows Server 2008 и Windows Vista.]
Вызывается GINA , чтобы указать альтернативный рабочий стол приложения, на который winlogon будет переключаться при завершении текущей функции обработки событий sas .
Синтаксис
PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;
BOOL PwlxSetReturnDesktop(
[in] HANDLE hWlx,
[in] PWLX_DESKTOP pDesktop
)
{...}
Параметры
[in] hWlx
Указывает дескриптор Winlogon, передаваемый в GINA в вызове WlxInitialize .
[in] pDesktop
Указатель на сведения о рабочем столе для альтернативного рабочего стола. Этот рабочий стол создается путем вызова функции WlxCreateUserDesktop .
Возвращаемое значение
Функция WlxSetReturnDesktop возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Вызов функции выполнен успешно. |
|
Вызов функции не смог задать возвращаемый рабочий стол. |
Комментарии
WlxSetReturnDesktop можно вызывать только в подпрограммах WlxLoggedOnSAS или WlxWkstaLockedSAS . Попытки вызвать эту функцию в другое время завершатся ошибкой.
Если указан дескриптор рабочего стола, Winlogon будет дублировать дескриптор. Если дескриптор не указан, Winlogon попытается открыть рабочий стол с именем в параметре pDesktop . Если предоставленный рабочий стол является недопустимым или является рабочим столом Winlogon или заставки, вызов завершится ошибкой.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winwlx.h |