PWLX_SET_RETURN_DESKTOP función de devolución de llamada (winwlx.h)

Artículo
08/28/2023

[La función WlxSetReturnDesktop ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

Lo llama GINA para especificar el escritorio de aplicación alternativo al que Winlogon cambiará cuando se complete la función de procesamiento de eventos de secuencia de atención segura (SAS) actual.

Nota Los archivos DLL de GINA se omiten en Windows Vista.

Sintaxis

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

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

Parámetros

[in] hWlx

Especifica el identificador de Winlogon pasado a GINA en la llamada a WlxInitialize .

[in] pDesktop

Puntero a información de escritorio sobre el escritorio alternativo. Este escritorio se crea mediante una llamada a la función WlxCreateUserDesktop .

Valor devuelto

La función WlxSetReturnDesktop devuelve uno de los valores siguientes.

Código devuelto	Descripción
TRUE	Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.
FALSE	La llamada de función no pudo establecer el escritorio devuelto.

Observaciones

Solo se puede llamar a WlxSetReturnDesktop dentro de las rutinas WlxLoggedOnSAS o WlxWkstaLockedSAS. Se producirá un error en los intentos de llamar a esta función en otros momentos.

Si se proporciona un identificador para el escritorio, Winlogon duplicará el identificador. Si no se proporciona ningún identificador, Winlogon intentará abrir el escritorio denominado en el parámetro pDesktop . Si el escritorio proporcionado no es válido o es el escritorio del protector de pantalla o Winlogon, se producirá un error en la llamada.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winwlx.h

Consulte también