IDebugControl2::OpenLogFile-Methode (dbgeng.h)

Artikel
02/23/2024

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

Syntax

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

Parameter

[in] File

Gibt den Namen der Protokolldatei an. Die 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. Bei TRUE werden Protokollmeldungen an die Datei angefügt. Wenn FALSE, wird der Inhalt einer vorhandenen Datei verworfen, die Datei entspricht.

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.

Hinweise

OpenLogFile und OpenLogFileWide verhalten sich genauso wie OpenLogFile2 und OpenLogFile2Wide , wobei Flags auf DEBUG_LOG_APPEND festgelegt sind, wenn Appendtrue ist und andernfalls DEBUG_LOG_DEFAULT.

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 Verwenden von Eingabe und Ausgabe.