IDebugControl2::GetLogFile-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetLogFile-Methode gibt den Namen der derzeit 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 PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Zeichen an.

[out, optional] FileSize

Empfängt die Größe des Namens der Protokolldatei in Zeichen. Wenn FileSizeNULL 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 Pufferpuffer zu passen, sodass der Name abgeschnitten wurde.
E_NOINTERFACE	Es ist derzeit keine geöffnete Protokolldatei vorhanden.

Hinweise

GetLogFile und GetLogFileWide verhalten sich genauso wie GetLogFile2 und GetLogFile2Wide , wobei Append nur die Informationen zum DEBUG_LOG_APPEND-Flag empfängt.

Weitere Informationen zu Protokolldateien finden Sie unter Verwenden von Eingabe und Ausgabe.