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.
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 |
|---|---|
|
Si se devuelve este valor, significará que la llamada a la función se realizó correctamente. |
|
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 |