IHttpUser::GetUserVariable, méthode

Retourne les données utilisateur personnalisées par nom.

Syntaxe

virtual PVOID GetUserVariable(  
   IN PCSTR pszVariableName  
) = 0;  

Paramètres

pszVariableName
[IN] Pointeur vers une chaîne null constante qui contient le nom de variable des données à récupérer.

Valeur renvoyée

Pointeur void qui contient les données personnalisées upcast.

Remarques

La valeur par défaut est HTTP_USER_VARIABLE_SID, qui est définie dans le fichier d’en-tête Httpserv.h.

Remarques pour les implémenteurs

Les implémenteurs IHttpUser 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 delete le void 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 delete le pointeur retourné void lorsque ces données ne sont plus nécessaires. En outre, les clients ne doivent pas modifier l’état de la mémoire référencée par ce void pointeur, car 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 similaire à ce qui suit dans le flux de réponse.

<?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