Metode IDebugClient5::OpenDumpFileWide (dbgeng.h)

Artikel
02/23/2024

Metode OpenDumpFileWide membuka file cadangan sebagai target debugger.

Sintaks

HRESULT OpenDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle
);

Parameter

[in, optional] FileName

Menentukan nama file cadangan yang akan dibuka -- kecuali FileHandle bukan nol, dalam hal ini FileName hanya digunakan ketika mesin dikueri untuk nama file cadangan. FileName harus menyertakan ekstensi nama file. FileName dapat mencakup jalur relatif atau absolut; jalur relatif relatif terhadap direktori tempat debugger dimulai. FileName juga dapat dalam bentuk URL file, dimulai dengan "file://". Jika FileName menentukan file kabinet (.cab), file kabinet dicari untuk file pertama dengan ekstensi .kdmp, lalu .hdmp, kemudian .mdmp, dan akhirnya .dmp.

[in] FileHandle

Menentukan handel file dari file cadangan yang akan dibuka. Jika FileHandle adalah nol, FileName digunakan untuk membuka file cadangan. Jika tidak, jika FileName bukan NULL, mesin mengembalikannya saat dikueri untuk nama file cadangan. Jika FileHandle bukan nol dan FileName adalah NULL, mesin akan mengembalikan HandleOnly untuk nama file.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Versi ASCII dari metode ini adalah OpenDumpFile.

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.