Metodo IDebugControl3::GetLogFile (dbgeng.h)

Articolo
02/25/2024

Il metodo GetLogFile restituisce il nome del file di log attualmente aperto.

Sintassi

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

Parametri

[out, optional] Buffer

Riceve il nome del file di log attualmente aperto. Se buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

Specifica le dimensioni, in caratteri , del buffer buffer.

[out, optional] FileSize

Riceve le dimensioni, in caratteri, del nome del file di log. Se FileSize è NULL, queste informazioni non vengono restituite.

[out] Append

Riceve TRUE se i messaggi di log vengono aggiunti al file di log o FALSE se il contenuto del file di log è stato rimosso quando il file è stato aperto.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, il nome del file di log era troppo lungo per adattarsi al buffer buffer in modo che il nome fosse troncato.
E_NOINTERFACE	Non è attualmente disponibile alcun file di log aperto.

Commenti

GetLogFile e GetLogFileWide si comportano allo stesso modo di GetLogFile2 e GetLogFile2Wide con Accodamento che riceve solo le informazioni sul flag di DEBUG_LOG_APPEND.

Per altre informazioni sui file di log, vedere Uso dell'input e dell'output.