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