Metodo IHttpTraceContext::GetTraceConfiguration

Articolo
07/19/2023

Restituisce la configurazione di traccia per il contesto di traccia.

Sintassi

virtual HRESULT GetTraceConfiguration(  
   IN OUT HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration  
) = 0;

Parametri

pHttpTraceConfiguration
[IN] [OUT] Puntatore a una struttura HTTP_TRACE_CONFIGURATION che contiene informazioni per la configurazione della traccia.

Valore restituito

Oggetto HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

valore	Definizione
S_OK	Indica che l'operazione ha avuto esito positivo.

Commenti

Chiamare il metodo per determinare se esiste un consumer di eventi prima di chiamare il GetTraceConfiguration metodo RaiseTraceEvent .

Nota

Anche se gli implementatori IHttpTraceContext correnti restituiscono solo S_OK da GetTraceConfiguration, è consigliabile testare l'esito positivo o negativo passando rispettivamente le macro restituite alle macro SUCCESSEDHRESULT o FAILED, perché l'implementazione può cambiare.

Thread safety

La maggior parte degli implementatori dell'interfaccia IHttpTraceContext è thread safe se viene chiamato solo il GetTraceConfiguration metodo. La chiamata al metodo SetTraceConfiguration non è garantita come thread safe.

Note per gli implementatori

Gli implementatori del GetTraceConfiguration metodo sono responsabili della copia di tutti i dati interni nella HTTP_TRACE_CONFIGURATION struttura, perché i chiamanti sono responsabili della eliminazione di questi dati quando non è più necessario.

Note per i chiamanti

I chiamanti al GetTraceConfiguration metodo sono responsabili della eliminazione di tutti HTTP_TRACE_CONFIGURATION i dati e dei relativi campi quando questi dati non sono più necessari.

Per altre informazioni su come creare e distribuire un modulo DLL nativo, vedere Procedura dettagliata: Creazione di un modulo HTTP Request-Level tramite codice nativo.

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 IHttpTraceContext
Metodo IHttpTraceContext::SetTraceConfiguration

Condividi tramite