IHttpTraceContext::GetTraceActivityId-Methode

Gibt den Bezeichner der Ablaufverfolgungsaktivität für den Ablaufverfolgungskontext zurück.

Syntax

virtual LPCGUID GetTraceActivityId(  
) = 0;  

Parameter

Diese Methode nimmt zwei Parameter entgegen.

Rückgabewert

Ein Zeiger auf eine konstante GUID; andernfalls NULL.

Bemerkungen

Das Verhalten dieser Methode hängt von der Implementierung ab. Einige Implementierungen geben immer NULL zurück, während andere die IHttpRequest::GetRawHttpRequest-Methode für einen internen IHttpRequest-Zeiger aufrufen und den zurückgegebenen HTTP_REQUEST Zeiger in einen const GUID-Zeiger konvertieren.

Achtung

Da einige Implementierer NULL zurückgeben, überprüfen Sie immer, ob die zurückgegebene LPCGUID nicht NULL ist, bevor Sie Vorgänge für diese Daten ausführen.

Hinweise für Implementierer

IHttpTraceContext-Implementierer sind für die Speicherverwaltung mit diesen Daten verantwortlich. Daher müssen Implementierer, die die dynamische Speicherbelegung verwenden, IHttpTraceContext den LPCGUID-Zeiger freigeben oder aufrufen delete , wenn er nicht mehr benötigt wird.

Hinweise für Aufrufer

IHttpTraceContext -Implementierer sind für die Speicherverwaltung mit diesen Daten verantwortlich; IHttpTraceContext Daher dürfen Clients den zurückgegebenen LPCGUID-Zeiger nicht freigeben oder aufrufen delete , wenn diese Daten nicht mehr benötigt werden. Darüber hinaus dürfen Clients diese Daten nicht in einen Zeiger umwandeln, der kein const ist, oder den Zustand des Arbeitsspeichers ändern, auf den von dieser LPCGUID verwiesen wird. Andernfalls wird eine Zugriffsverletzung ausgelöst oder die Daten werden ungültig.

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 unter 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 unter 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