Metodo IHttpUser::GetUserName

Restituisce il nome utente.

Sintassi

virtual PCWSTR GetUserName(  
   VOID  
) = 0;  

Parametri

Questo metodo non accetta parametri.

Valore restituito

Puntatore a una stringa Unicode con terminazione null costante contenente il nome utente.

Commenti

Il valore restituito dipende dal tipo di autenticazione. Il tipo di autenticazione viene restituito dal metodo GetAuthenticationType .

Nella tabella seguente vengono illustrati i tipi di autenticazione con i valori o il modello di nome utente associati.

Tipo di autenticazione	Nome utente
Anonimo	stringa vuota
Basic	Dominio\Nome utente
Digest	dominio\nome utente o nome utente
Forms	username
Windows	Dominio\Nome utente

Note per gli implementatori

IHttpUser gli implementatori sono responsabili della gestione della memoria con questi dati; pertanto, IHttpUser gli implementatori che usano l'allocazione dinamica della memoria devono rilasciare o chiamare delete il PCWSTR puntatore quando non è più necessario.

Note per i chiamanti

IHttpUser gli implementatori sono responsabili della gestione della memoria con questi dati; pertanto, IHttpUser i client non devono rilasciare o chiamare delete sul puntatore restituito PCWSTR quando questi dati non sono più necessari. Inoltre, i client non devono eseguire il cast di questi dati in un puntatore che non è un const oggetto o modificare lo stato della memoria a cui PCWSTRfa riferimento. In caso contrario, verrà generata una violazione di accesso o i dati non saranno validi.

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 nel flusso di risposta simile al seguente.

<?xml version="1.0" ?>  
<user userName="DOMAIN\user" />  

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

Vedere anche

Interfaccia IHttpUser
Metodo IHttpUser::GetPassword
Metodo IHttpUser::GetRemoteUserName