IHttpTraceContext::GetTraceActivityId 方法

返回跟踪上下文的跟踪活动标识符。

语法

virtual LPCGUID GetTraceActivityId(  
) = 0;  

参数

此方法不采用参数。

返回值

指向常量 GUID 的指针;否则为 NULL。

备注

此方法的行为取决于实现。 某些实现始终返回 NULL,而其他实现在内部 IHttpRequest 指针上调用 IHttpRequest::GetRawHttpRequest 方法,并将返回的HTTP_REQUEST指针转换为 const GUID 指针。

注意

由于某些实现程序返回 NULL,因此在对此数据执行任何操作之前,请始终验证返回的 LPCGUID 是否为 NULL。

实现者须知

IHttpTraceContext 实现者负责使用此数据进行内存管理;因此, IHttpTraceContext 使用动态内存分配的实现者必须在不再需要 LPCGUID 指针时释放或调用 delete 该指针。

对调用者的说明

IHttpTraceContext 实现者负责使用此数据进行内存管理;因此,当不再需要此数据时, IHttpTraceContext 客户端不得释放或调用 delete 返回的 LPCGUID 指针。 此外,客户端不得将此数据强制转换为不是 const 的指针或更改此 LPCGUID 引用的内存的状态;否则,将引发访问冲突或数据将变为无效。

有关如何创建和部署本机 DLL 模块的详细信息,请参阅 演练:使用本机代码创建Request-Level HTTP 模块

要求

类型 说明
客户端 - Windows Vista 上的 IIS 7.0
- Windows 7 上的 IIS 7.5
- Windows 8 上的 IIS 8.0
- Windows 10 上的 IIS 10.0
服务器 - Windows Server 2008 上的 IIS 7.0
- Windows Server 2008 R2 上的 IIS 7.5
- Windows Server 2012 上的 IIS 8.0
- Windows Server 2012 R2 上的 IIS 8.5
- Windows Server 2016 上的 IIS 10.0
产品 - 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

另请参阅

IHttpTraceContext 接口