Método IDebugControl3::OpenLogFile (dbgeng.h)

Artigo
02/23/2024

O método OpenLogFile abre um arquivo de log que receberá a saída dos objetos do cliente.

Sintaxe

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

Parâmetros

[in] File

Especifica o nome do arquivo de log. O arquivo pode incluir um caminho relativo ou absoluto; os caminhos relativos são relativos ao diretório no qual o depurador foi iniciado. Se o arquivo não existir, ele será criado.

[in] Append

Especifica se as mensagens de log devem ou não ser acrescentadas a um arquivo de log existente. Se TRUE, as mensagens de log serão acrescentadas ao arquivo; se FALSE, o conteúdo de qualquer Arquivo correspondente de arquivo existente será descartado.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

OpenLogFile e OpenLogFileWide se comportam da mesma maneira que OpenLogFile2 e OpenLogFile2Wide com Sinalizadores definidos como DEBUG_LOG_APPEND se Append for TRUE e DEBUG_LOG_DEFAULT caso contrário.

Somente um arquivo de log pode ser aberto por vez. Se já houver um arquivo de log aberto, ele será fechado.

Para obter mais informações sobre arquivos de log, consulte Usando entrada e saída.