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. 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 |
|---|---|
|
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) |