IHttpTraceContext::GetTraceActivityId メソッド
トレース コンテキストのトレース アクティビティ識別子を返します。
構文
virtual LPCGUID GetTraceActivityId(
) = 0;
パラメーター
このメソッドは、パラメーターを受け取りません。
戻り値
定数 GUID へのポインター。それ以外の場合は NULL。
解説
このメソッドの動作は実装によって異なります。 実装によっては常に NULL が返されますが、内部 IHttpRequest ポインターで IHttpRequest::GetRawHttpRequest メソッドを呼び出し、返された HTTP_REQUEST ポインターを GUID ポインターに変換するconst実装もあります。
注意事項
一部の実装者は NULL を返すので、このデータに対する操作を実行する前に、返された LPCGUID が NULL ではないことを常に確認してください。
実装側の注意
IHttpTraceContext の実装者は、このデータを使用したメモリ管理を担当します。そのため、 IHttpTraceContext 動的メモリ割り当てを使用する実装者は、不要になったときに LPCGUID ポインターを解放または呼び出す delete 必要があります。
呼び出し元に関する注意事項
IHttpTraceContext 実装者は、このデータを使用したメモリ管理を担当します。そのため、クライアントは、 IHttpTraceContext このデータが不要になったときに、返された LPCGUID ポインターを解放または呼び出 delete す必要はありません。 さらに、クライアントは const 、このデータをポインターにキャストしたり、この LPCGUID によって参照されるメモリの状態を変更したりすることはできません。それ以外の場合は、アクセス違反がスローされるか、データが無効になります。
ネイティブ 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 |