IDebugControl::OpenLogFile-Methode (dbgeng.h)

Artikel
02/06/2025

Die OpenLogFile--Methode öffnet eine Protokolldatei, die die Ausgabe von den Clientobjektenempfängt.

Syntax

HRESULT OpenLogFile(
  [in] PCSTR File,
  [in] BOOL  Append
);

Parameter

[in] File

Gibt den Namen der Protokolldatei an. Datei- kann einen relativen oder absoluten Pfad enthalten; Relative Pfade sind relativ zum Verzeichnis, in dem der Debugger gestartet wurde. Wenn die Datei nicht vorhanden ist, wird sie erstellt.

[in] Append

Gibt an, ob Protokollmeldungen an eine vorhandene Protokolldatei angefügt werden sollen. Wenn TRUE, werden Protokollmeldungen an die Datei angefügt; wenn FALSE, werden die Inhalte vorhandener Dateiabgleiche Datei verworfen.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

OpenLogFile und OpenLogFileWide- sich auf die gleiche Weise wie OpenLogFile2- und OpenLogFile2Wide- mit Flags auf DEBUG_LOG_APPEND festgelegt, wenn AppendTRUE und andernfalls DEBUG_LOG_DEFAULT ist.

Es kann jeweils nur eine Protokolldatei geöffnet werden. Wenn bereits eine Protokolldatei geöffnet ist, wird sie geschlossen.

Weitere Informationen zu Protokolldateien finden Sie unter Using Input and Output.