PWLX_SET_RETURN_DESKTOP fonction de rappel (winwlx.h)

Article
08/28/2023

[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

Share via