IHttpUser Interface

Article
07/19/2023

Fournit des informations spécifiques à la demande sur un utilisateur. Ces informations incluent des données telles que les informations d’identification et l’autorisation basée sur les rôles.

Syntaxe

class IHttpUser

Méthodes

Le tableau suivant répertorie les méthodes exposées par l’interface IHttpUser .

Rubrique	Description
DereferenceUser	Décrémente le nombre de références internes de l’utilisateur.
GetAuthenticationType	Retourne le type d’authentification de la demande.
GetImpersonationToken	Retourne le jeton d’emprunt d’identité utilisateur.
GetPassword	Retourne le mot de passe utilisateur.
GetPrimaryToken	Retourne le jeton d’utilisateur principal.
GetRemoteUserName	Retourne le nom d’utilisateur distant.
GetUserName	Retourne le nom d’utilisateur.
GetUserVariable	Retourne les données utilisateur personnalisées par nom.
Isinrole	Retourne une valeur qui indique si l’utilisateur est autorisé pour un rôle nommé.
ReferenceUser	Incrémente le nombre de références internes de l’utilisateur.
SupportsIsInRole	Retourne une valeur qui indique si la prise en charge des rôles est activée pour l’utilisateur.

Classes dérivées

Cette interface ne contient aucune classe dérivée.

Remarques

Vous pouvez récupérer un IHttpUser pointeur à partir d’un pointeur IHttpContext en appelant la méthode IHttpContext::GetUser . Pour accéder à ces interfaces, consultez Procédure pas à pas : création d’un module HTTP Request-Level à l’aide de code natif.

Exemple

L’exemple de code suivant montre comment créer un module HTTP qui efface les en-têtes et le corps de la réponse, puis retourne les informations utilisateur au client sous forme de document XML.

Le code ci-dessus écrit du code XML similaire à ce qui suit dans le flux de réponse.

<?xml version="1.0" ?>  
<user   
    userName="DOMAIN\user"   
    remoteName=" DOMAIN\user"   
    passWord="[hidden]"   
    authType="Negotiate"   
    impersonationToken="valid"   
    primaryToken="valid"   
    supportsRoles="true"   
    isInRole="false"   
    userVariable="NULL" />

Votre module doit exporter la fonction RegisterModule . Vous pouvez exporter cette fonction en créant un fichier de définition de module (.def) pour votre projet, ou vous pouvez compiler le module à l’aide du /EXPORT:RegisterModule commutateur. Pour plus d’informations, consultez Procédure pas à pas : création d’un module HTTP Request-Level à l’aide de code natif.

Vous pouvez éventuellement compiler le code à l’aide de la __stdcall (/Gz) convention d’appel au lieu de déclarer explicitement la convention d’appel pour chaque fonction.

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
En-tête	Httpserv.h

Voir aussi

Interfaces principales du serveur web

Partager via