IHttpTraceCoNtext：：SetTraceConfiguration 方法
設定追蹤內容的追蹤組態。
語法
virtual HRESULT SetTraceConfiguration(
IN HTTP_MODULE_ID moduleId,
IN HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration,
IN DWORD cHttpTraceConfiguration = 1
) = 0;)
參數
moduleId
[IN] HTTP_MODULE_ID 指標，其中包含追蹤組態的模組識別碼。
pHttpTraceConfiguration
[IN]長度 cHttpTraceConfigurationHTTP_TRACE_CONFIGURATION 結構的陣列。
cHttpTraceConfiguration
[IN]DWORD，其中包含 所 pHttpTraceConfiguration 指向的結構 HTTP_TRACE_CONFIGURATION 數目。 預設值是 1。
注意
HTTP_MODULE_ID 是指標的類型 void 定義。
傳回值
HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 值 | 定義 |
|---|---|
| S_OK | 表示作業成功。 |
| E_FAIL | 表示作業失敗。 |
| E_OUTOFMEMORY | 表示內部 new 作業傳回 Null，因為堆積記憶體已耗盡。 |
| ERROR_INVALID_PARAMETER | HTTP_TRACE_CONFIGURATION::pProviderGuid表示 參數的 pHttpTraceConfiguration 屬性為 Null。 |
| ERROR_NOT_FOUND | 表示嘗試停用不存在之提供者的追蹤。 |
備註
和 moduleIdpHttpTraceConfiguration 參數都不能是 Null， SetTraceConfiguration 否則方法將會導致存取違規。
執行緒安全性
只有在呼叫GetTraceConfiguration方法時，IHttpTraceCoNtext介面的大部分實作者都是安全線程。 SetTraceConfiguration呼叫 方法不保證為安全線程。
註解
如需如何建立和部署原生 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 |