Metodo IHttpUser::GetUserVariable
Restituisce i dati utente personalizzati in base al nome.
Sintassi
virtual PVOID GetUserVariable(
IN PCSTR pszVariableName
) = 0;
Parametri
pszVariableName
[IN] Puntatore a una stringa con terminazione null costante contenente il nome della variabile dei dati da recuperare.
Valore restituito
Puntatore void contenente i dati personalizzati upcast.
Commenti
Il valore predefinito è HTTP_USER_VARIABLE_SID, definito nel file di intestazione Httpserv.h.
Note per gli implementatori
I implementer IHttpUser sono responsabili della gestione della memoria con questi dati; pertanto, IHttpUser gli implementatori che usano l'allocazione dinamica della memoria devono rilasciare o delete il void 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 delete il puntatore restituito void quando questi dati non sono più necessari. Inoltre, i client non devono modificare lo stato della memoria a cui fa riferimento questo void puntatore, perché 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 simile al seguente al flusso di risposta.
<?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 |