CloseTrace-Funktion (evntrace.h)

Die CloseTrace-Funktion schließt eine Ablaufverfolgungsverarbeitungssitzung, die mit OpenTrace erstellt wurde.

Syntax

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI CloseTrace(
  [in] TRACEHANDLE TraceHandle
);

Parameter

[in] TraceHandle

Handle, um die Ablaufverfolgungsverarbeitungssitzung zu schließen. Die OpenTrace-Funktion gibt dieses Handle zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Systemfehlercodes. Im Folgenden finden Sie einige häufige Fehler und deren Ursachen.

• ERROR_INVALID_HANDLE

  Es trifft eine der folgenden Bedingungen zu:

  • TraceHandle ist 0.
  • TraceHandle ist INVALID_PROCESSTRACE_HANDLE.
  • TraceHandle ist kein gültiges Handle.

• ERROR_BUSY

  Vor Windows Vista können Sie die Ablaufverfolgung erst schließen, wenn die ProcessTrace-Funktion abgeschlossen ist.

• ERROR_CTX_CLOSE_PENDING

  Der Aufruf war erfolgreich. Die ProcessTrace-Funktion wird beendet, nachdem sie alle Echtzeitereignisse in ihren Puffern verarbeitet hat (sie empfängt keine neuen Ereignisse).

Hinweise

Consumer rufen diese Funktion auf, um ein von OpenTrace zurückgegebenes Ablaufverfolgungshandle zu schließen.

Wenn Sie Ereignisse aus einer Protokolldatei verarbeiten, rufen Sie diese Funktion erst auf, nachdem die ProcessTrace-Funktion zurückgegeben wurde. Wenn Sie jedoch Echtzeitereignisse verarbeiten, können Sie diese Funktion aufrufen, bevor ProcessTrace zurückgegeben wird. (Eine weitere Möglichkeit zum Beenden der Ablaufverfolgungsverarbeitung besteht darin, FALSE von BufferCallback zurückzugeben.)

Wenn Sie diese Funktion aufrufen, bevor ProcessTrace zurückgegeben wird, gibt die CloseTrace-Funktion ERROR_CTX_CLOSE_PENDING zurück. Der ERROR_CTX_CLOSE_PENDING Code gibt an, dass der CloseTrace-Funktionsaufruf erfolgreich war. Die ProcessTrace-Funktion beendet die Verarbeitung von Ereignissen, nachdem sie alle zuvor in die Warteschlange gestellten Ereignisse verarbeitet hat (ProcessTrace empfängt keine neuen Ereignisse, nachdem Sie die CloseTrace-Funktion aufgerufen haben). Sie können die CloseTrace-Funktion über Ihren BufferCallback-, EventCallback- oder EventClassCallback-Rückruf aufrufen.

Vor Windows Vista: Sie können CloseTrace nur aufrufen, nachdem ProcessTrace zurückgegeben wurde.

Beispiele

Ein Beispiel, das CloseTrace verwendet, finden Sie unter Abrufen von Ereignisdaten mithilfe von TDH.

Anforderungen

Weitere Informationen

OpenTrace

ProcessTrace