Metode IDebugClient5::WriteDumpFileWide (dbgeng.h)

Metode WriteDumpFileWide membuat mode pengguna atau file cadangan kernel-modecrash.

Sintaks

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

Parameter

[in, optional] FileName

Menentukan nama file cadangan yang akan dibuat. FileName harus menyertakan ekstensi nama file. FileName dapat mencakup jalur relatif atau absolut; jalur relatif relatif terhadap direktori tempat debugger dimulai. Jika FileHandle bukan NULL, FileName diabaikan (kecuali saat menulis pesan status ke konsol debugger).

[in] FileHandle

Menentukan handel file untuk menulis crash dump. Jika FileHandleADALAH NULL, file yang ditentukan dalam FileName digunakan sebagai gantinya.

[in] Qualifier

Menentukan jenis cadangan yang akan dibuat. Untuk nilai yang mungkin, lihat DEBUG_DUMP_XXX.

[in] FormatFlags

Menentukan bendera yang menentukan format file cadangan dan--untuk minidumps mode pengguna--informasi apa yang akan disertakan dalam file. Untuk detailnya, lihat DEBUG_FORMAT_XXX.

[in, optional] Comment

Menentukan string komentar yang akan disertakan dalam file crash dump. String ini ditampilkan di konsol debugger saat file cadangan dimuat.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode Deskripsi
S_OK
Metode berhasil.

Keterangan

Untuk informasi selengkapnya tentang file crash dump, lihat Target File Dump.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)

Lihat juga

.dump (Buat File Cadangan)

IDebugClient4

IDebugClient5

WriteDumpFile2