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

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 for NULL, FileName será ignorado (exceto ao gravar status mensagens 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 memória. Essa cadeia de caracteres é exibida no console do depurador quando o arquivo de despejo é carregado.

Valor retornado

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

Para obter mais informações sobre arquivos de despejo de memória, consulte Destinos de arquivo de despejo.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

.dump (Criar arquivo de despejo)

IDebugClient4

IDebugClient5

WriteDumpFile2