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

Artigo
02/06/2025

O método GetLogFileWide retorna o nome do arquivo de log aberto no momento.

Sintaxe

HRESULT GetLogFileWide(
  [out, optional] PWSTR  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG FileSize,
  [out]           PBOOL  Append
);

Parâmetros

[out, optional] Buffer

Recebe o nome do arquivo de log aberto no momento. Se buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em caracteres, do buffer de do buffer de.

[out, optional] FileSize

Recebe o tamanho, em caracteres, do nome do arquivo de log. Se FileSize estiver NULL, essas informações não serão retornadas.

[out] Append

Recebe VERDADEIRO se as mensagens de log forem acrescentadas ao arquivo de log ou false se o conteúdo do arquivo de log tiver sido descartado quando o arquivo foi aberto.

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.
S_FALSE	O método foi bem-sucedido. No entanto, o nome do arquivo de log era muito longo para caber no buffer buffer para que o nome fosse truncado.
E_NOINTERFACE	Não há nenhum arquivo de log aberto no momento.

Observações

GetLogFile e GetLogFileWide se comportam da mesma maneira que GetLogFile2 e GetLogFile2Wide com Append recebendo apenas as informações sobre o sinalizador DEBUG_LOG_APPEND.

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

closeLogFile

GetLogFile2

GetLogMask

IDebugControl4

OpenLogFile

Compartilhar via