IHttpUser::GetUserName, méthode
Retourne le nom d’utilisateur.
Syntaxe
virtual PCWSTR GetUserName(
VOID
) = 0;
Paramètres
Cette méthode ne prend aucun paramètre.
Valeur renvoyée
Pointeur vers une chaîne Unicode terminée par null constante qui contient le nom d’utilisateur.
Remarques
La valeur retournée dépend du type d’authentification. Le type d’authentification est retourné à partir de la méthode GetAuthenticationType .
Le tableau suivant montre les types d’authentification avec les valeurs ou le modèle de nom d’utilisateur associés.
| Type d'authentification | Nom d'utilisateur |
|---|---|
| Anonyme | Chaîne vide |
| Basic | Domaine\nom d'utilisateur |
| Digest | domaine\nom d’utilisateur ou nom d’utilisateur |
| Formulaires | username |
| Windows | Domaine\nom d'utilisateur |
Remarques pour les implémenteurs
IHttpUser les implémenteurs sont responsables de la gestion de la mémoire avec ces données ; par conséquent, IHttpUser les implémenteurs qui utilisent l’allocation de mémoire dynamique doivent libérer ou appeler delete le PCWSTR pointeur lorsqu’il n’est plus nécessaire.
Remarques pour les appelants
IHttpUser les implémenteurs sont responsables de la gestion de la mémoire avec ces données ; par conséquent, IHttpUser les clients ne doivent pas libérer ou appeler delete le pointeur retourné PCWSTR lorsque ces données ne sont plus nécessaires. En outre, les clients ne doivent pas caster ces données en un pointeur qui n’est pas un const ou modifier l’état de la mémoire référencée par ce PCWSTR; sinon, une violation d’accès sera levée ou les données deviendront non valides.
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 dans le flux de réponse comme suit.
<?xml version="1.0" ?>
<user userName="DOMAIN\user" />
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
IHttpUser Interface
IHttpUser::GetPassword, méthode
IHttpUser::GetRemoteUserName, méthode