IDebugControl2::GetLogFile-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetLogFile Methode gibt den Namen der aktuell geöffneten Protokolldatei zurück.

Syntax

HRESULT GetLogFile(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG FileSize,
  [out]           PBOOL  Append
);

Parameter

[out, optional] Buffer

Empfängt den Namen der aktuell geöffneten Protokolldatei. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Puffer- Puffers in Zeichen an.

[out, optional] FileSize

Empfängt die Größe des Namens der Protokolldatei in Zeichen. Wenn FileSize-NULL-ist, werden diese Informationen nicht zurückgegeben.

[out] Append

Empfängt TRUE, wenn Protokollmeldungen an die Protokolldatei angefügt werden, oder FALSE, wenn der Inhalt der Protokolldatei beim Öffnen der Datei verworfen wurde.

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.
S_FALSE	Die Methode war erfolgreich. Der Name der Protokolldatei war jedoch zu lang, um in den Puffer Puffer einzupassen, sodass der Name abgeschnitten wurde.
E_NOINTERFACE	Zurzeit ist keine geöffnete Protokolldatei vorhanden.

Bemerkungen

GetLogFile und GetLogFileWide verhalten sich auf die gleiche Weise wie GetLogFile2 und GetLogFile2Wide mit Anfügen nur die Informationen zum DEBUG_LOG_APPEND Flag empfangen.

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