Compartir a través de


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

[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

WlxCreateUserDesktop

WlxInitialize

WlxLoggedOnSAS

WlxWkstaLockedSAS