IDebugControl4::OpenLogFile2-Methode (dbgeng.h)

Artikel
02/06/2025

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

Syntax

HRESULT OpenLogFile2(
  [in] PCSTR File,
  [in] ULONG Flags
);

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] Flags

Gibt die Bit-Flags an, die die Art der Protokolldatei steuern. Flags können Flags aus der folgenden Tabelle enthalten.

Flagge	Effekt beim Festlegen
DEBUG_LOG_APPEND	Die Ausgabe wird an die Protokolldatei angefügt, anstatt den Inhalt der Protokolldatei zu verwerfen.
DEBUG_LOG_UNICODE	Das Format der Protokolldatei ist Unicode anstelle von ASCII.

Alternativ können Flags für den Standardsatz von Optionen, die keines der Flags enthalten, auf DEBUG_LOG_DEFAULT festgelegt werden.

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

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.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

.logappend (Append Log File)

.logopen (Protokolldatei öffnen)

Freigeben über