IHttpTraceContext::SetTraceConfiguration-Methode

Artikel
07/19/2023

Legt die Ablaufverfolgungskonfiguration für den Ablaufverfolgungskontext fest.

Syntax

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

Parameter

moduleId
[IN] Ein HTTP_MODULE_ID Zeiger, der den Modulbezeichner für die Ablaufverfolgungskonfiguration enthält.

pHttpTraceConfiguration
[IN] Ein Array von HTTP_TRACE_CONFIGURATION Strukturen der Länge cHttpTraceConfiguration.

cHttpTraceConfiguration
[IN] Eine DWORD , die die Anzahl von HTTP_TRACE_CONFIGURATION Strukturen enthält, auf die von verwiesen wird pHttpTraceConfiguration. Der Standardwert ist 1.

Hinweis

HTTP_MODULE_ID ist eine Typdefinition eines void Zeigers.

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert	Definition
S_OK	Gibt an, dass der Vorgang erfolgreich war.
E_FAIL	Gibt an, dass beim Vorgang ein Fehler aufgetreten ist.
E_OUTOFMEMORY	Gibt an, dass ein interner `new` Vorgang NULL zurückgegeben hat, weil der Heapspeicher erschöpft ist.
ERROR_INVALID_PARAMETER	Gibt an, dass die `HTTP_TRACE_CONFIGURATION::pProviderGuid` Eigenschaft für den `pHttpTraceConfiguration` Parameter NULL ist.
ERROR_NOT_FOUND	Gibt an, dass für einen Anbieter, der nicht vorhanden ist, versucht wurde, die Ablaufverfolgung zu deaktivieren.

Bemerkungen

Weder der moduleId noch der pHttpTraceConfiguration Parameter kann NULL sein. Andernfalls verursacht die SetTraceConfiguration Methode eine Zugriffsverletzung.

Threadsicherheit

Die meisten Implementierer der IHttpTraceContext-Schnittstelle sind threadsicher, wenn nur die GetTraceConfiguration-Methode aufgerufen wird. Das Aufrufen der SetTraceConfiguration Methode ist nicht garantiert threadsicher.

Kommentare

Weitere Informationen zum Erstellen und Bereitstellen eines nativen DLL-Moduls finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Request-Level HTTP-Moduls mithilfe von nativem Code.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 auf Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 auf Windows Server 2016
Produkt	– 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
Header	Httpserv.h

Weitere Informationen

IHttpTraceContext-Schnittstelle

Freigeben über