Metodo IDebugControl::GetLogFile (dbgeng.h)

Articolo
02/06/2025

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 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 altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, il nome del file di log era troppo lungo per rientrare nel buffer buffer in modo che il nome sia stato troncato.
E_NOINTERFACE	Attualmente non è disponibile alcun file di log aperto.

Osservazioni

GetLogFile e GetLogFileWide si comportano allo stesso modo di GetLogFile2 e GetLogFile2Wide con Append ricevere solo le informazioni sul flag DEBUG_LOG_APPEND.

Per altre informazioni sui file di log, vedere Using Input and Output.