IHttpUser-Schnittstelle
Stellt anforderungsspezifische Informationen zu einem Benutzer bereit. Diese Informationen umfassen Daten wie Anmeldeinformationen und rollenbasierte Autorisierung.
Syntax
class IHttpUser
Methoden
In der folgenden Tabelle sind die Methoden aufgeführt, die von der IHttpUser
-Schnittstelle verfügbar gemacht werden.
Thema | BESCHREIBUNG |
---|---|
DereferenceUser | Verringert die Anzahl der benutzerinternen Verweise. |
GetAuthenticationType | Gibt den Anforderungsauthentifizierungstyp zurück. |
GetImpersonationToken | Gibt das Identitätswechseltoken des Benutzers zurück. |
Getpassword | Gibt das Benutzerkennwort zurück. |
GetPrimaryToken | Gibt das primäre Benutzertoken zurück. |
GetRemoteUserName | Gibt den Remotebenutzernamen zurück. |
GetUserName | Gibt den Benutzernamen zurück. |
GetUserVariable | Gibt die benutzerdefinierten Benutzerdaten nach Namen zurück. |
Isinrole | Gibt einen Wert zurück, der angibt, ob der Benutzer für eine benannte Rolle autorisiert ist. |
ReferenceUser | Erhöht die anzahl der internen Verweise des Benutzers. |
SupportsIsInRole | Gibt einen Wert zurück, der angibt, ob die Rollenunterstützung für den Benutzer aktiviert ist. |
Abgeleitete Klassen
Diese Schnittstelle enthält keine abgeleiteten Klassen.
Bemerkungen
Sie können einen IHttpUser
Zeiger aus einem IHttpContext-Zeiger abrufen, indem Sie die IHttpContext::GetUser-Methode aufrufen. Informationen zum Zugriff auf diese Schnittstellen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Request-Level HTTP-Moduls mithilfe von nativem Code.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein HTTP-Modul erstellen, das die Antwortheader und den Text löscht und dann Benutzerinformationen als XML-Dokument an den Client zurückgibt.
Der obige Code schreibt XML, das dem folgenden ähnelt, in den Antwortdatenstrom.
<?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" />
Ihr Modul muss die RegisterModule-Funktion exportieren. Sie können diese Funktion exportieren, indem Sie eine Moduldefinitionsdatei (.def) für Ihr Projekt erstellen, oder Sie können das Modul mithilfe des Schalters /EXPORT:RegisterModule
kompilieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Request-Level HTTP-Moduls mithilfe von nativem Code.
Sie können den Code optional kompilieren, indem Sie die __stdcall (/Gz)
Aufrufkonvention verwenden, anstatt die Aufrufkonvention für jede Funktion explizit zu deklarieren.
Anforderungen
type | BESCHREIBUNG |
---|---|
Client | – IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 unter Windows 10 |
Server | – IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 unter Windows Server 2016 |
Produkt | – 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 |
Header | Httpserv.h |