Partager via


PWLX_ASSIGN_SHELL_PROTECTION fonction de rappel (winwlx.h)

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

Appelé par GINA pour affecter la protection au programme shell d’un utilisateur nouvellement connecté.

Note Les DLL GINA sont ignorées dans Windows Vista.
 
Le processus de l’interpréteur de commandes doit être créé dans un état suspendu, puis la fonction WlxAssignShellProtection doit être appelée pour appliquer la protection appropriée au processus de l’interpréteur de commandes.

Cette fonction a été remplacée par la fonction CreateProcessAsUser de l’API Windows.

Syntaxe

PWLX_ASSIGN_SHELL_PROTECTION PwlxAssignShellProtection;

int PwlxAssignShellProtection(
  [in] HANDLE hWlx,
  [in] HANDLE hToken,
  [in] HANDLE hProcess,
  [in] HANDLE hThread
)
{...}

Paramètres

[in] hWlx

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

[in] hToken

Spécifie le handle à un jeton principal.

[in] hProcess

Spécifie le handle du processus à modifier. Le processus doit être créé dans l’état suspendu, et il doit s’agir du handle retourné dans la structure PROCESS_INFORMATION .

[in] hThread

Spécifie le handle du thread initial du processus.

Valeur retournée

La fonction WlxAssignShellProtection retourne toutes les erreurs rencontrées lors de la tentative d’attribution de la protection.

Remarques

La fonction CreateProcessAsUser de l’API Windows remplace WlxAssignShellProtection. Appelez CreateProcessAsUser dans WlxActivateUserShell pour créer le processus shell et définir ses protections dans un seul appel.

Configuration requise

Condition requise Valeur
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

CreateProcessAsUser

WlxActivateUserShell

WlxInitialize