トレース コンテキストのトレース構成を設定します。
構文
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 |