PWLX_SET_RETURN_DESKTOP funzione di callback (winwlx.h)
[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.
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 |
|---|---|
|
La chiamata di funzione ha avuto esito positivo. |
|
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 |