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
}