IDiaDataSourceEx::loadDataFromPdbEx
Otevře a připraví soubor databáze programu (.pdb) jako ladicí zdroj dat s volitelným předběžném načtením záznamu.
Syntaxe
HRESULT loadDataFromPdbEx (
LPCOLESTR pdbPath,
BOOL fPdbPrefetching
);
Parametry
pdbPath
[v] Cesta k souboru .pdb.
fPdbPrefetching
[v] Pokud je nastavená možnost TRUE
, sousední ladicí záznamy se předem načítají do paměti, potenciálně nahradí mnoho menších vstupně-výstupních operací s menším počtem operací, většími operacemi a tím se zlepší celková propustnost, protože se k těmto záznamům následně přistupuje, a to na úkor potenciálně zvýšeného využití paměti. Pokud je nastavená hodnota FALSE
, chová se stejně jako IDiaDataSource::loadDataFromPdb
. Pokud je nastavená na jinou hodnotu, chování není zadané.
Návratová hodnota
V případě úspěchu vrátí hodnotu S_OK
; v opačném případě vrátí kód chyby. Následující tabulka ukazuje možné návratové hodnoty pro tuto metodu.
Hodnota | Popis |
---|---|
E_PDB_NOT_FOUND |
Soubor se nepodařilo otevřít nebo se zjistilo, že soubor má neplatný formát. |
E_PDB_FORMAT |
Pokusili jste se o přístup k souboru s nekompatibilním nebo nepodporovaným formátem. |
E_INVALIDARG |
Neplatný parametr. |
E_UNEXPECTED |
Zdroj dat je již připravený. |
Poznámky
Tato metoda načte ladicí data přímo ze souboru .pdb.
K ověření souboru .pdb na základě konkrétních kritérií použijte metodu IDiaDataSourceEx::loadAndValidateDataFromPdbEx
.
Pokud chcete získat přístup k procesu načítání dat (prostřednictvím mechanismu zpětného volání), použijte metodu IDiaDataSourceEx::loadDataForExeEx
.
K načtení souboru .pdb přímo z paměti použijte metodu IDiaDataSourceEx::loadDataFromIStreamEx
.
K ověření souboru .pdb bez načtení použijte metodu IDiaDataSourceEx::ValidatePdb
.
Příklad
HRESULT hr = pSource->loadDataFromPdbEx( L"myprog.pdb", TRUE );
if (FAILED(hr))
{
// report error
}