Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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