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	パラメーターの プロパティpHttpTraceConfigurationが HTTP_TRACE_CONFIGURATION::pProviderGuid NULL であることを示します。
ERROR_NOT_FOUND	存在しないプロバイダーに対してトレースを無効にしようとしたことを示します。

解説

moduleIdパラメーターも パラメーターも pHttpTraceConfiguration NULL にすることはできません。それ以外のSetTraceConfiguration場合、メソッドはアクセス違反を引き起こします。

スレッド セーフ

GetTraceConfiguration メソッドのみが呼び出された場合、IHttpTraceContext インターフェイスのほとんどの実装者はスレッド セーフです。 メソッドの SetTraceConfiguration 呼び出しは、スレッド セーフであるとは限りません。

説明

ネイティブ DLL モジュールを作成してデプロイする方法の詳細については、「 チュートリアル: ネイティブ コードを使用したRequest-Level HTTP モジュールの作成」を参照してください。

要件

Type	説明
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
Header	Httpserv.h

参照

IHttpTraceContext インターフェイス