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


IDiaDataSourceEx::loadDataFromPdbEx

Открывает и подготавливает файл базы данных программы (PDB) в качестве источника данных отладки с необязательной предварительной выборкой записей.

Синтаксис

HRESULT loadDataFromPdbEx (
   LPCOLESTR pdbPath,
   BOOL      fPdbPrefetching
);

Параметры

pdbPath

[in] Путь к PDB-файлу.

fPdbPrefetching

[in] Если задано значение TRUE, смежные записи отладки предварительно извлекаются в память, потенциально заменяя многие операции ввода-вывода меньшего размера файлов меньшими, большими операциями и таким образом повышая общую пропускную способность по мере последующего доступа к этим записям, за счет потенциально повышенного использования памяти. Если задано значение FALSE, это поведение идентично IDiaDataSource::loadDataFromPdb. Если задано какое-то другое значение, поведение не указано.

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

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

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

Замечания

Этот метод загружает данные отладки непосредственно из PDB-файла.

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

Чтобы получить доступ к процессу загрузки данных (с помощью механизма обратного вызова), используйте IDiaDataSourceEx::loadDataForExeEx этот метод.

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

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

Пример

HRESULT hr = pSource->loadDataFromPdbEx( L"myprog.pdb", TRUE );
if (FAILED(hr))
{
    // report error
}

См. также