Compartilhar via


Método IDebugControl4::OpenLogFile2 (dbgeng.h)

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

Sintaxe

HRESULT OpenLogFile2(
  [in] PCSTR File,
  [in] ULONG Flags
);

Parâmetros

[in] File

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

[in] Flags

Especifica os sinalizadores de bits que controlam a natureza do arquivo de log. Sinalizadores podem conter sinalizadores da tabela a seguir.

Bandeira Efeito quando definido
DEBUG_LOG_APPEND A saída será acrescentada ao arquivo de log em vez de descartar o conteúdo do arquivo de log.
DEBUG_LOG_UNICODE O formato do arquivo de log será Unicode em vez de ASCII.
 

Como alternativa, sinalizadores podem ser definidos como DEBUG_LOG_DEFAULT para o conjunto padrão de opções que não contém nenhum dos sinalizadores.

Valor de retorno

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

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

Observações

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 Usandode entrada e saída.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

.logappend (Arquivo de Log de Acréscimo)

.logopen (Abrir Arquivo de Log)

closeLogFile

GetLogFile2

GetLogMask

IDebugControl4

OpenLogFile

SetLogMask