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 メソッド