IHttpTraceContext：：GetTraceConfiguration 方法

返回跟踪上下文的跟踪配置。

语法

virtual HRESULT GetTraceConfiguration(  
   IN OUT HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration  
) = 0;

pHttpTraceConfiguration
[IN][OUT]指向包含跟踪配置信息的 HTTP_TRACE_CONFIGURATION 结构的指针。

HRESULT。可能的值包括（但并不限于）下表中的项。

值	定义
S_OK	指示操作成功。

调用方法以确定 GetTraceConfiguration 在调用 RaiseTraceEvent 方法之前是否存在事件使用者。

注意

虽然当前 IHttpTraceContext 实现程序仅从 GetTraceConfiguration返回S_OK，但应分别通过将返回 HRESULT 的传递给 SUCCEEDED 或 FAILED 宏来测试成功或失败，因为实现可能会更改。

如果只GetTraceConfiguration调用方法，则 IHttpTraceContext 接口的大多数实现程序都是线程安全的。调用 SetTraceConfiguration 方法不能保证线程安全。

方法的 GetTraceConfiguration 实现者负责将任何内部数据复制到结构中 HTTP_TRACE_CONFIGURATION ，因为调用方负责在不再需要此数据时处理这些数据。

方法的 GetTraceConfiguration 调用方负责在不再需要此数据时释放任何 HTTP_TRACE_CONFIGURATION 数据及其字段。

有关如何创建和部署本机 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