IDiaDataSource::loadDataForExe

Статья
05/15/2024

Открывает и подготавливает данные отладки, связанные с файлом .exe/.dll.

Синтаксис

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

Параметры

executable

[in] Путь к файлу .exe или .dll.

searchPath

[in] Альтернативный путь для поиска данных отладки.

pCallback

[in] Интерфейс IUnknown для объекта, который поддерживает интерфейс обратного вызова отладки, например IDiaLoadCallback, IDiaLoadCallback2, IDiaReadExeAtOffsetCallback и /или интерфейсы IDiaReadExeAtRVACallback .

Возвращаемое значение

В случае успешного выполнения возвращается S_OK; в противном случае возвращается код ошибки. В следующей таблице показаны некоторые возможные коды ошибок для этого метода.

значение	Описание
E_PDB_NOT_FOUND	Не удалось открыть файл или файл имеет недопустимый формат.
E_PDB_FORMAT	Попытка получить доступ к файлу с устаревшим форматом.
E_PDB_INVALID_SIG	Подпись не соответствует.
E_PDB_INVALID_AGE	Возраст не соответствует.
E_INVALIDARG	Недопустимый параметр .
E_UNEXPECTED	Источник данных уже подготовлен.

Замечания

Заголовок отладки файла .exe/.dll называет связанное расположение данных отладки.

Если данные отладки загружаются с сервера символов, symsrv.dll должны присутствовать в том же каталоге, где установлено приложение пользователя или msdia140.dll, или он должен присутствовать в системном каталоге.

Этот метод считывает заголовок отладки, а затем ищет и подготавливает данные отладки. Ход выполнения поиска может сообщаться и контролироваться с помощью обратных вызовов. Например, метод IDiaLoadCallback::NotifyDebugDir вызывается при поиске IDiaDataSource::loadDataForExe и обработке каталога отладки.

Интерфейсы IDiaReadExeAtOffsetCallback и IDiaReadExeAtRVACallback позволяют клиентскому приложению предоставлять альтернативные методы для чтения данных из исполняемого файла, если доступ к файлу невозможен напрямую через стандартный ввод-вывод файла.

Чтобы загрузить PDB-файл без проверки, используйте метод IDiaDataSource::loadDataFromPdb .

Чтобы проверить PDB-файл с определенными критериями, используйте метод IDiaDataSource::loadAndValidateDataFromPdb .

Чтобы загрузить PDB-файл непосредственно из памяти, используйте метод IDiaDataSource::loadDataFromIStream .

Пример

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

Поделиться через