IHttpTraceContext::GetTraceActivityId メソッド

トレース コンテキストのトレース アクティビティ識別子を返します。

構文

virtual LPCGUID GetTraceActivityId(  
) = 0;  

パラメーター

このメソッドは、パラメーターを受け取りません。

戻り値

定数 GUID へのポインター。それ以外の場合は NULL。

解説

このメソッドの動作は実装によって異なります。 実装によっては常に NULL が返されますが、内部 IHttpRequest ポインターで IHttpRequest::GetRawHttpRequest メソッドを呼び出し、返された HTTP_REQUEST ポインターを GUID ポインターに変換するconst実装もあります。

実装側の注意

IHttpTraceContext の実装者は、このデータを使用したメモリ管理を担当します。そのため、 IHttpTraceContext 動的メモリ割り当てを使用する実装者は、不要になったときに LPCGUID ポインターを解放または呼び出す delete 必要があります。

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

IHttpTraceContext 実装者は、このデータを使用したメモリ管理を担当します。そのため、クライアントは、 IHttpTraceContext このデータが不要になったときに、返された LPCGUID ポインターを解放または呼び出 delete す必要はありません。 さらに、クライアントは const 、このデータをポインターにキャストしたり、この LPCGUID によって参照されるメモリの状態を変更したりすることはできません。それ以外の場合は、アクセス違反がスローされるか、データが無効になります。

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

要件

参照

IHttpTraceContext インターフェイス