Método IDebugClient5::WriteDumpFileWide (dbgeng.h)

Artigo
02/06/2025

O método WriteDumpFileWide cria um arquivo de despejo de modo de usuário ou kernel-modecrash.

Sintaxe

HRESULT WriteDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Qualifier,
  [in]           ULONG   FormatFlags,
  [in, optional] PCWSTR  Comment
);

Parâmetros

[in, optional] FileName

Especifica o nome do arquivo de despejo a ser criado. FileName deve incluir a extensão de nome de arquivo. FileName pode incluir um caminho relativo ou absoluto; caminhos relativos são relativos ao diretório no qual o depurador foi iniciado. Se FileHandle não estiver NULL, FileName será ignorado (exceto ao gravar mensagens de status no console do depurador).

[in] FileHandle

Especifica o identificador de arquivo do arquivo para o qual gravar o despejo de falha. Se FileHandle for NULL, o arquivo especificado em FileName será usado.

[in] Qualifier

Especifica o tipo de despejo a ser criado. Para obter valores possíveis, consulte DEBUG_DUMP_XXX.

[in] FormatFlags

Especifica sinalizadores que determinam o formato do arquivo de despejo e, para minidumps no modo de usuário, quais informações incluir no arquivo. Para obter detalhes, consulte DEBUG_FORMAT_XXX.

[in, optional] Comment

Especifica uma cadeia de caracteres de comentário a ser incluída no arquivo de despejo de falha. Essa cadeia de caracteres é exibida no console do depurador quando o arquivo de despejo é carregado.

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

Para obter mais informações sobre arquivos de despejo de falhas, consulte Dump-File Targets.

Requisitos

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

Consulte também

.dump (Criar arquivo de despejo)

IDebugClient4

IDebugClient5

WriteDumpFile2

Compartilhar via