Interfaccia IHttpUser
Fornisce informazioni specifiche della richiesta su un utente. Queste informazioni includono dati come le credenziali e l'autorizzazione basata sul ruolo.
Sintassi
class IHttpUser
Metodi
Nella tabella seguente sono elencati i metodi esposti dall'interfaccia IHttpUser
.
Argomento | Descrizione |
---|---|
DereferenceUser | Decrementa il conteggio dei riferimenti interni dell'utente. |
GetAuthenticationType | Restituisce il tipo di autenticazione della richiesta. |
GetImpersonationToken | Restituisce il token di rappresentazione dell'utente. |
Getpassword | Restituisce la password utente. |
GetPrimaryToken | Restituisce il token utente primario. |
GetRemoteUserName | Restituisce il nome utente remoto. |
GetUserName | Restituisce il nome utente. |
GetUserVariable | Restituisce i dati utente personalizzati in base al nome. |
Isinrole | Restituisce un valore che indica se l'utente è autorizzato per un ruolo denominato. |
ReferenceUser | Incrementa il conteggio dei riferimenti interni dell'utente. |
SupportIsInRole | Restituisce un valore che indica se il supporto del ruolo è abilitato per l'utente. |
Classi derivate
Questa interfaccia non contiene classi derivate.
Commenti
È possibile recuperare un puntatore da un IHttpUser
puntatore IHttpContext chiamando il metodo IHttpContext::GetUser . Per ottenere l'accesso a queste interfacce, vedere Procedura dettagliata: Creazione di un modulo HTTP Request-Level tramite codice nativo.
Esempio
Nell'esempio di codice seguente viene illustrato come creare un modulo HTTP che cancella le intestazioni di risposta e il corpo e quindi restituisce le informazioni utente al client come documento XML.
Il codice precedente scrive xml simile al seguente al flusso di risposta.
<?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" />
Il modulo deve esportare la funzione RegisterModule . È possibile esportare questa funzione creando un file di definizione del modulo (con estensione def) per il progetto oppure è possibile compilare il modulo usando l'opzione /EXPORT:RegisterModule
. Per altre informazioni, vedere Procedura dettagliata: Creazione di un modulo HTTP Request-Level tramite codice nativo.
Facoltativamente, è possibile compilare il codice usando la __stdcall (/Gz)
convenzione chiamante anziché dichiarare esplicitamente la convenzione chiamante per ogni funzione.
Requisiti
Tipo | Descrizione |
---|---|
Client | - IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10 |
Server | - IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016 |
Prodotto | - 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 |
Intestazione | Httpserv.h |