Condividi tramite


Metodo IHttpTraceContext::SetTraceConfiguration

Imposta la configurazione della traccia per il contesto di traccia.

Sintassi

virtual HRESULT SetTraceConfiguration(  
   IN HTTP_MODULE_ID moduleId,  
   IN HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration,  
   IN DWORD cHttpTraceConfiguration = 1  
) = 0;)  

Parametri

moduleId
[IN] Puntatore HTTP_MODULE_ID contenente l'identificatore del modulo per la configurazione della traccia.

pHttpTraceConfiguration
[IN] Matrice di strutture HTTP_TRACE_CONFIGURATION di lunghezza cHttpTraceConfiguration.

cHttpTraceConfiguration
[IN] Oggetto DWORD contenente il numero di HTTP_TRACE_CONFIGURATION strutture puntate da pHttpTraceConfiguration. Il valore predefinito è 1.

Nota

HTTP_MODULE_ID è una definizione di tipo di puntatore void .

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.
E_FAIL Indica che l'operazione non è riuscita.
E_OUTOFMEMORY Indica che un'operazione interna new ha restituito NULL perché la memoria heap è esaurita.
ERROR_INVALID_PARAMETER Indica che la proprietà per il HTTP_TRACE_CONFIGURATION::pProviderGuidpHttpTraceConfiguration parametro è NULL.
ERROR_NOT_FOUND Indica che si è verificato un tentativo di disabilitare la traccia per un provider che non esiste.

Commenti

Né il moduleIdpHttpTraceConfiguration parametro può essere NULL. In caso contrario, il SetTraceConfiguration metodo causerà una violazione di accesso.

Thread safety

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

Commenti

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