Bagikan melalui

IDiaDataSource::loadDataForExe

Membuka dan menyiapkan data debug yang terkait dengan .exe/.dll file.

Sintaks

HRESULT loadDataForExe (
   LPCOLESTR executable,
   LPCOLESTR searchPath,
   IUnknown* pCallback
);

Parameter

dapat dieksekusi

[di] Jalur ke .exe file atau .dll .

searchPath

[di] Jalur alternatif untuk mencari data debug. Beberapa jalur harus dibatasi titik koma. Jalur mungkin berisi trailing \.

pCallback

[in] Antarmuka IUnknown untuk objek yang mendukung antarmuka panggilan balik debug, seperti IDiaLoadCallback, IDiaLoadCallback2, IDiaReadExeAtOffsetCallback, dan/atau antarmuka IDiaReadExeAtRVACallback.

Tampilkan Nilai

Jika berhasil, mengembalikan S_OK; jika tidak, mengembalikan kode galat. Tabel berikut menunjukkan beberapa kemungkinan kode kesalahan untuk metode ini.

Nilai Deskripsi
E_PDB_NOT_FOUND Gagal membuka file, atau file memiliki format yang tidak valid.
E_PDB_FORMAT Mencoba mengakses file dengan format tidak terpakai.
E_PDB_INVALID_SIG Tanda tangan tidak cocok.
E_PDB_INVALID_AGE Usia tidak cocok.
E_INVALIDARG Parameter tidak valid.
E_UNEXPECTED Sumber data telah disiapkan.

Keterangan

Header debug file menamai .exe/.dll lokasi data debug terkait.

Jika Anda memuat data debug dari server simbol, symsrv.dll harus ada di direktori yang sama di mana aplikasi pengguna atau msdia140.dll diinstal, atau harus ada di direktori sistem.

Metode ini membaca header debug lalu mencari dan menyiapkan data debug. Progres pencarian dapat, secara opsional, dilaporkan dan dikontrol melalui panggilan balik. Misalnya, IDiaLoadCallback::NotifyDebugDir dipanggil ketika IDiaDataSource::loadDataForExe metode menemukan dan memproses direktori debug.

Antarmuka IDiaReadExeAtOffsetCallback dan IDiaReadExeAtRVACallback memungkinkan aplikasi klien untuk menyediakan metode alternatif untuk membaca data dari file yang dapat dieksekusi ketika file tidak dapat diakses langsung melalui I/O file standar.

Untuk memuat .pdb file dengan prefetching rekaman simbol, gunakan IDiaDataSourceEx::loadDataForExeEx metode .

Untuk memuat file .pdb tanpa validasi, gunakan metode .IDiaDataSource::loadDataFromPdb

Untuk memvalidasi file .pdb terhadap kriteria tertentu, gunakan metode .IDiaDataSource::loadAndValidateDataFromPdb

Untuk memuat file .pdb langsung dari memori, gunakan metode .IDiaDataSource::loadDataFromIStream

Untuk memvalidasi file .pdb tanpa memuatnya, gunakan IDiaDataSourceEx::ValidatePdb metode .

Contoh

class MyCallBack: public IDiaLoadCallback
{
...
};
MyCallBack callback;
...
HRESULT hr = pSource->loadDataForExe( L"myprog.exe", L".\debug", (IUnknown*)&callback);
if (FAILED(hr))
{
    // Report error
}

Lihat juga

  • Last updated on