title | description | ms.date | ms.assetid |
---|---|---|---|
ICacheProvider::GetTraceContext Method |
Describes the ICacheProvider::GetTraceContext method and details its syntax, parameters, return value, remarks, code example, and requirements. |
10/07/2016 |
82947c97-727f-455e-b773-9fa952194dc3 |
Returns the trace context for the cache provider.
virtual IHttpTraceContext* GetTraceContext(
VOID
) const = 0;
This method takes no parameters.
An IHttpTraceContext pointer.
CGlobalModule derived classes that register for GL_CACHE_OPERATION events receive an ICacheProvider pointer as a parameter on the CGlobalModule::OnGlobalCacheOperationvirtual
method. You can retrieve an IHttpTraceContext
pointer by calling the GetTraceContext
method on the ICacheProvider
pointer.
ICacheProvider
implementers are responsible for memory management with this data; therefore, ICacheProvider
implementers that use dynamic memory allocation must release or call delete
on the IHttpTraceContext
pointer when it is no longer needed.
ICacheProvider
implementers are responsible for memory management with this data; therefore, ICacheProvider
clients must not release or call delete
on the returned IHttpTraceContext
pointer when this data is no longer needed.
The following code example demonstrates how to create a global module that listens for GL_CACHE_OPERATION
and GL_CACHE_CLEANUP events and then writes the IHttpTraceContext
information to the Event Viewer.
Caution
[!INCLUDEiisver] generates a large number of events in the Event Viewer. To avoid a log overflow error in a production environment, you should generally avoid writing cache information to the event log. For demonstration purposes, this code example writes an entry to the Event Viewer in debug mode only.
[!code-cppICacheProvider#5]
For more information on how to create and deploy a native DLL module, see Walkthrough: Creating a Request-Level HTTP Module By Using Native Code.
The above code writes a new event to the application log of the Event Viewer, where the Data box contains XML similar to the following.
<cacheProvider>
<traceContext
activityId=
"{00000000-0000-0000-2400-0080000000FB}">
<traceConfiguration
providerGuid="NULL"
areas="0"
verbosity="0"
providerEnabled="false"/>
</traceContext>
</cacheProvider>
You can optionally compile the code by using the __stdcall (/Gz)
calling convention instead of explicitly declaring the calling convention for each function.
Type | Description |
---|---|
Client | - IIS 7.0 on [!INCLUDEwinvista] - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
Server | - IIS 7.0 on [!INCLUDEwinsrv2008] - 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 |
Product | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - [!INCLUDEiisexp75], [!INCLUDEiisexp80], [!INCLUDEiisexp100] |
Header | Httpserv.h |