Share via


IHttpUser::SupportsIsInRole-Methode

Gibt einen Wert zurück, der angibt, ob die Rollenunterstützung für den Benutzer aktiviert ist.

Syntax

virtual BOOL SupportsIsInRole(  
   VOID  
) = 0;  

Parameter

Diese Methode nimmt zwei Parameter entgegen.

Rückgabewert

true , wenn die Rollenunterstützung für den Benutzer aktiviert ist; falseandernfalls .

Bemerkungen

Der SupportsIsInRole Rückgabewert hängt von der Implementierung ab. Sie sollten die folgenden Informationen als Richtlinie verwenden, aber sie sind möglicherweise nicht in allen Szenarien korrekt:

  • Wenn der IHttpUser-Implementierer die verwaltete oder anonyme Authentifizierung verarbeitet, SupportsIsInRole wird zurückgegeben true.

  • Wenn der Implementierer die IHttpUser Authentifizierung "Custom", "Basic", "Certification Mapping" oder "SSPI" implementiert, SupportsIsInRole gibt zurück false.

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 supportsRoles="true" />  

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

IHttpUser-Schnittstelle