IHttpTraceContext::GetTraceConfiguration-Methode

Artikel
07/19/2023

Gibt die Ablaufverfolgungskonfiguration für den Ablaufverfolgungskontext zurück.

Syntax

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

Parameter

pHttpTraceConfiguration
[IN] [OUT] Ein Zeiger auf eine HTTP_TRACE_CONFIGURATION-Struktur , die Informationen für die Ablaufverfolgungskonfiguration enthält.

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.

Bemerkungen

Rufen Sie die GetTraceConfiguration -Methode auf, um zu ermitteln, ob ein Ereignis-Consumer vorhanden ist, bevor Sie die RaiseTraceEvent-Methode aufrufen.

Hinweis

Während aktuelle IHttpTraceContext-Implementierungen nur S_OK von GetTraceConfigurationzurückgeben, sollten Sie auf Erfolg oder Fehler testen, indem Sie die zurückgegebenen HRESULT an die Makros SUCCEEDED bzw . FAILED übergeben, da sich die Implementierung ändern kann.

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.

Hinweise für Implementierer

Implementierer der Methode sind für das GetTraceConfiguration Kopieren von internen Daten in die HTTP_TRACE_CONFIGURATION Struktur verantwortlich, da Aufrufer für die Entsorgung dieser Daten verantwortlich sind, wenn sie nicht mehr benötigt werden.

Hinweise für Aufrufer

Aufrufer der -Methode sind für die GetTraceConfiguration Entsorgung aller HTTP_TRACE_CONFIGURATION Daten und der zugehörigen Felder verantwortlich, wenn diese Daten nicht mehr benötigt werden.

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

Freigeben über