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