Partager via


PWLX_SET_RETURN_DESKTOP fonction de rappel (winwlx.h)

[La fonction WlxSetReturnDesktop n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

Appelé par GINA pour spécifier l’autre bureau d’application vers lequel Winlogon basculera lorsque la fonction de traitement d’événement de séquence d’attention sécurisée (SAS) actuelle est terminée.

Note Les DLL GINA sont ignorées dans Windows Vista.
 

Syntaxe

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

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

Paramètres

[in] hWlx

Spécifie le handle Winlogon passé à GINA dans l’appel WlxInitialize .

[in] pDesktop

Pointeur vers les informations du bureau sur le bureau de remplacement. Ce bureau est créé en appelant la fonction WlxCreateUserDesktop .

Valeur retournée

La fonction WlxSetReturnDesktop retourne l’une des valeurs suivantes.

Code de retour Description
TRUE
L’appel de fonction a abouti.
FALSE
L’appel de fonction n’a pas pu définir le bureau de retour.

Remarques

WlxSetReturnDesktop peut être appelé uniquement dans les routines WlxLoggedOnSAS ou WlxWkstaLockedSAS . Les tentatives d’appel de cette fonction à d’autres moments échouent.

Si un handle sur le bureau est fourni, Winlogon dupliquera le handle. Si aucun handle n’est fourni, Winlogon tente d’ouvrir le bureau nommé dans le paramètre pDesktop . Si le bureau fourni n’est pas valide ou s’il s’agit du bureau Winlogon ou de l’économiseur d’écran, l’appel échoue.

Spécifications

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winwlx.h

Voir aussi

WlxCreateUserDesktop

WlxInitialize

WlxLoggedOnSAS

WlxWkstaLockedSAS