IDebugControl4::OpenLogFile2-Methode (dbgeng.h)

Artikel
02/23/2024

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

Syntax

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

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

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

Flag	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.

Hinweise

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.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

.logappend (Protokolldatei anfügen)

.logopen (Protokolldatei öffnen)