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

Artigo
02/26/2024

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

Sintaxe

HRESULT GetLogFile(
  [out, optional] PSTR   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 buffer.

[out, optional] FileSize

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

[out] Append

Recebe TRUE 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.

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

Comentários

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