IHttpTraceContext::GetTraceConfiguration メソッド

  • [アーティクル]

トレース コンテキストのトレース構成を返します。

構文

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

パラメーター

pHttpTraceConfiguration
[IN][OUT]トレース構成の情報を含む HTTP_TRACE_CONFIGURATION 構造体へのポインター。

戻り値

HRESULT。 有効な値を次の表に示しますが、これ以外にもあります。

値 定義
S_OK 操作が成功したことを示します。

解説

RaiseTraceEvent メソッドをGetTraceConfiguration呼び出す前に、 メソッドを呼び出してイベント コンシューマーが存在するかどうかを確認します。

注意

現在の IHttpTraceContext 実装者は から GetTraceConfigurationS_OKのみを返しますが、実装が変更される可能性があるため、返された HRESULT を SUCCEEDED または FAILED マクロに渡すことで、成功または 失敗 をテストする必要があります。

スレッド セーフ

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

実装側の注意

メソッドの GetTraceConfiguration 実装者は、内部データを構造体に HTTP_TRACE_CONFIGURATION コピーする役割を担います。これは、呼び出し元が不要になったときにこのデータを破棄する責任があるためです。

呼び出し元に関する注意事項

メソッドの GetTraceConfiguration 呼び出し元は、このデータが不要になったときにデータとそのフィールドを HTTP_TRACE_CONFIGURATION 破棄する必要があります。

ネイティブ 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 インターフェイス
IHttpTraceContext::SetTraceConfiguration メソッド