Metodo IDebugControl3::OpenLogFile (dbgeng.h)

Articolo
02/06/2025

Il metodo OpenLogFile apre un file di log che riceverà l'output dagli oggetti client .

Sintassi

HRESULT OpenLogFile(
  [in] PCSTR File,
  [in] BOOL  Append
);

Parametri

[in] File

Specifica il nome del file di log. file può includere un percorso relativo o assoluto; i percorsi relativi sono relativi alla directory in cui è stato avviato il debugger. Se il file non esiste, verrà creato.

[in] Append

Specifica se aggiungere o meno messaggi di log a un file di log esistente. Se TRUE, i messaggi di log verranno aggiunti al file; se FALSE, il contenuto di qualsiasi file esistente corrispondente File viene rimosso.

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.

Osservazioni

OpenLogFile e OpenLogFileWide si comportano allo stesso modo di OpenLogFile2 e OpenLogFile2Wide con Flag impostato su DEBUG_LOG_APPEND se Append è TRUE e DEBUG_LOG_DEFAULT in caso contrario.

È possibile aprire un solo file di log alla volta. Se è già aperto un file di log, verrà chiuso.

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