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.

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

Voir aussi

IHttpUser Interface
IHttpUser::GetPassword, méthode
IHttpUser::GetRemoteUserName, méthode