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 |