PWLX_SET_RETURN_DESKTOP funzione di callback (winwlx.h)

Articolo
08/28/2023

[La funzione WlxSetReturnDesktop non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Chiamato da GINA per specificare il desktop dell'applicazione alternativo a cui Winlogon passerà quando la funzione di elaborazione degli eventi della sequenza di attenzione sicura corrente è completata.

Nota Le DLL GINA vengono ignorate in Windows Vista.

Sintassi

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

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

Parametri

[in] hWlx

Specifica l'handle Winlogon passato a GINA nella chiamata a WlxInitialize .

[in] pDesktop

Puntatore alle informazioni sul desktop sul desktop alternativo. Questo desktop viene creato chiamando la funzione WlxCreateUserDesktop .

Valore restituito

La funzione WlxSetReturnDesktop restituisce uno dei valori seguenti.

Codice restituito	Descrizione
TRUE	La chiamata di funzione ha avuto esito positivo.
FALSE	La chiamata di funzione non è riuscita a impostare il desktop restituito.

Commenti

WlxSetReturnDesktop può essere chiamato solo nelle routine WlxLoggedOnSAS o WlxWkstaLockedSAS . I tentativi di chiamare questa funzione in altri momenti avranno esito negativo.

Se viene fornito un handle per il desktop, Winlogon duplicerà l'handle. Se non viene fornito alcun handle, Winlogon tenterà di aprire il desktop denominato nel parametro pDesktop . Se il desktop fornito non è valido o è il desktop Winlogon o screen saver, la chiamata avrà esito negativo.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winwlx.h

Vedi anche