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 模組。

類型	描述
Client	- 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
標頭	Httpserv.h