Metode IDebugClient2::OpenDumpFile (dbgeng.h)

Artikel
02/23/2024

Metode OpenDumpFile membuka file cadangan sebagai target debugger.

Sintaks

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Parameter

[in] DumpFile

Menentukan nama file cadangan yang akan dibuka. DumpFile harus menyertakan ekstensi nama file. DumpFile dapat mencakup jalur relatif atau absolut; jalur relatif relatif terhadap direktori tempat debugger dimulai. DumpFile dapat memiliki bentuk URL file, dimulai dengan "file://". Jika DumpFile menentukan file kabinet (.cab), file kabinet dicari untuk file pertama dengan ekstensi .kdmp, lalu .hdmp, kemudian .mdmp, dan akhirnya .dmp.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Versi Unicode dari metode ini adalah OpenDumpFileWide.

Catatan Mesin tidak sepenuhnya terpasang ke file cadangan sampai metode WaitForEvent telah dipanggil. Saat file cadangan dibuat dari proses atau kernel, informasi tentang peristiwa terakhir disimpan dalam file cadangan. Setelah file cadangan dibuka, eksekusi berikutnya dicoba, mesin akan menghasilkan peristiwa ini untuk panggilan balik peristiwa. Hanya dengan begitu file cadangan tersedia dalam sesi penelusuran kesalahan.

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