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 |