Metode IDebugClient5::GetDumpFile (dbgeng.h)

Metode GetDumpFile menjelaskan file yang berisi informasi pendukung yang digunakan saat membuka target cadangan saat ini.

Sintaks

HRESULT GetDumpFile(
  [in]            ULONG    Index,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Handle,
  [out]           PULONG   Type
);

Parameter

[in] Index

Menentukan file mana yang akan dijelaskan. Indeks dapat mengambil nilai antara nol dan jumlah file dikurangi satu; jumlah file dapat ditemukan dengan menggunakan GetNumberDumpFiles.

[out, optional] Buffer

Menerima nama file. Jika BufferNULL, informasi ini tidak dikembalikan.

[in] BufferSize

Menentukan ukuran dalam karakter buffer Buffer. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri.

[out, optional] NameSize

Menerima ukuran nama file. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri. Jika NameSizeNULL, informasi ini tidak dikembalikan.

[out, optional] Handle

Menerima handel file dari file. Jika HandelNULL, informasi ini tidak dikembalikan.

[out] Type

Menerima jenis file.

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 Cadangan.

Persyaratan

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

Lihat juga

AddDumpInformationFile

AddDumpInformationFileWide

GetNumberDumpFiles

IDebugClient4

IDebugClient5