CloseTrace

CloseTrace 関数は、OpenTrace で作成されたトレース処理セッションを閉じる。

CloseTrace TraceHandle

TraceHandle : [int] 閉じるトレース処理セッションへのハンドル。[OpenTrace](/windows/win32/api/evntrace/nf-evntrace-opentracea) 関数がこのハンドルを返す。

(プラグイン / モジュール : advapi32.dll)

解説

CloseTrace 関数は、OpenTrace で作成されたトレース処理セッションを閉じる。

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は
[システムエラーコード](/windows/win32/debug/system-error-codes)
のいずれかとなる。以下に一般的なエラーとその原因を示す。- **ERROR_INVALID_HANDLE** 以下のいずれかが真である:
- _TraceHandle_ が **0** である。- _TraceHandle_ が
**INVALID_PROCESSTRACE_HANDLE** である。- _TraceHandle_ が有効なハンドルではない。-
**ERROR_BUSY** Windows Vista
より前では、[ProcessTrace](/windows/win32/api/evntrace/nf-evntrace-processtrace)
関数が完了するまでトレースを閉じることはできない。- **ERROR_CTX_CLOSE_PENDING**
呼び出しは成功した。[ProcessTrace](/windows/win32/api/evntrace/nf-evntrace-processtrace)
関数は、バッファ内のすべてのリアルタイムイベントを処理した後に停止する（新しいイベントは受け取らない）。

[備考]
コンシューマは本関数を呼び出して **OpenTrace** が返したトレースハンドルを閉じる。> [!Important] >
**StartTrace**
が返したトレースハンドルを閉じるのに本関数を使用してはならない。ログファイルからイベントを処理している場合、本関数は
[ProcessTrace](/windows/win32/api/evntrace/nf-evntrace-processtrace)
関数が復帰した後にのみ呼び出す。ただし、リアルタイムイベントを処理している場合は、**ProcessTrace**
が復帰する前に本関数を呼び出してもよい（トレース処理を停止する別の方法は
[BufferCallback](/windows/win32/api/evntrace/nc-evntrace-pevent_trace_buffer_callbacka)
から FALSE を返すことである）。**ProcessTrace** が復帰する前に本関数を呼び出した場合、**CloseTrace**
関数は ERROR_CTX_CLOSE_PENDING を返す。ERROR_CTX_CLOSE_PENDING コードは
**CloseTrace** 関数呼び出しが成功したことを示す。**ProcessTrace**
関数は、以前にキューに入れられたイベントをすべて処理した後にイベント処理を停止する（**CloseTrace**
関数を呼び出した後は新しいイベントを受け取らない）。**CloseTrace** 関数は
[BufferCallback](/windows/desktop/ETW/buffercallback)、[EventCallback](/windows/desktop/ETW/eventcallback)、[EventClassCallback](/windows/desktop/ETW/eventclasscallback)
コールバックから呼び出すことができる。> **Windows Vista 以前:** **CloseTrace** は >
[ProcessTrace](/windows/win32/api/evntrace/nf-evntrace-processtrace)
が復帰した後にのみ呼び出せる。

情報