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

Weitere Informationen

Webserverkernschnittstellen