IHttpTraceContext::GetTraceActivityId Method
Returns the trace activity identifier for the trace context.
Syntax
virtual LPCGUID GetTraceActivityId(
) = 0;
Parameters
This method takes no parameters.
Return Value
A pointer to a constant GUID; otherwise, NULL.
Remarks
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.
Warning
Because some implementers return NULL, always verify that the returned LPCGUID is not NULL before you perform any operations on this data.
Notes for Implementers
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.
Notes for Callers
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 |