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

  • Artigo

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. O 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 bit que controlam a natureza do arquivo de log. Os sinalizadores podem conter sinalizadores da tabela a seguir.

Sinalizador 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, os Sinalizadores podem ser definidos como DEBUG_LOG_DEFAULT para o conjunto padrão de opções que não contém nenhum dos sinalizadores.

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

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.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

.logappend (Append Log File)

.logopen (Abrir Arquivo de Log)

CloseLogFile

GetLogFile2

GetLogMask

IDebugControl4

OpenLogFile

SetLogMask