IHttpTraceContext::GetTraceActivityId Method

IIS 7.0
 

Returns the trace activity identifier for the trace context.

virtual LPCGUID GetTraceActivityId(
) = 0;

This method takes no parameters.

A pointer to a constant GUID; otherwise, NULL.

The behavior of this method depends on implementation. Some implementations always return NULL, while others call the IHttpRequest::GetRawHttpRequest method on an internal IHttpRequest pointer and convert the returned HTTP_REQUEST pointer to a const GUID pointer.

System_CAPS_cautionCaution

Because some implementers return NULL, always verify that the returned LPCGUID is not NULL before you perform any operations on this data.

IHttpTraceContext implementers are responsible for memory management with this data; therefore, IHttpTraceContext implementers that use dynamic memory allocation must release or call delete on the LPCGUID pointer when it is no longer needed.

IHttpTraceContext implementers are responsible for memory management with this data; therefore, IHttpTraceContext clients must not release or call delete on the returned LPCGUID pointer when this data is no longer needed. Furthermore, clients must not cast this data to a pointer that is not a const or change the state of the memory referenced by this LPCGUID; otherwise, an access violation will be thrown or the data will become invalid.

For more information about how to create and deploy a native DLL module, see Walkthrough: Creating a Request-Level HTTP Module By Using Native Code.

Requirements

Type

Description

Client

  • IIS 7.0 on Windows Vista

  • IIS 7.5 on Windows 7

  • IIS 8.0 on Windows 8

  • IIS 10.0 on Windows 10

Server

  • IIS 7.0 on Windows Server 2008

  • IIS 7.5 on Windows Server 2008 R2

  • IIS 8.0 on Windows Server 2012

  • IIS 8.5 on Windows Server 2012 R2

  • IIS 10.0 on Windows Server 2016 Technical Preview

Product

  • 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

Show: