IDiaDataSourceEx::loadDataFromPdbEx
Otwiera i przygotowuje plik bazy danych programu (.pdb) jako źródło danych debugowania z opcjonalnym pobieraniem rekordów.
Składnia
HRESULT loadDataFromPdbEx (
LPCOLESTR pdbPath,
BOOL fPdbPrefetching
);
Parametry
pdbPath
[in] Ścieżka do pliku .pdb.
fPdbPrefetching
[in] Jeśli ustawiono TRUEwartość , sąsiadujące rekordy debugowania są wstępnie pobierane do pamięci, potencjalnie zastępując wiele mniejszych operacji we/wy plików mniejszą liczbą, większymi operacjami, a tym samym poprawiając ogólną przepływność, ponieważ te rekordy są następnie dostępne, kosztem potencjalnie zwiększonego użycia pamięci. Jeśli jest ustawiona wartość FALSE, zachowuje się identycznie z wartością IDiaDataSource::loadDataFromPdb. Jeśli zostanie ustawiona inna wartość, zachowanie jest nieokreślone.
Wartość zwracana
Jeśli operacja powiedzie się, zwraca wartość S_OK; w przeciwnym razie zwraca kod błędu. W poniższej tabeli przedstawiono możliwe wartości zwracane dla tej metody.
| Wartość | Opis |
|---|---|
E_PDB_NOT_FOUND |
Nie można otworzyć pliku lub ustalić, że plik ma nieprawidłowy format. |
E_PDB_FORMAT |
Podjęto próbę uzyskania dostępu do pliku z niezgodnym lub nieobsługiwanym formatem. |
E_INVALIDARG |
Nieprawidłowy parametr. |
E_UNEXPECTED |
Źródło danych zostało już przygotowane. |
Uwagi
Ta metoda ładuje dane debugowania bezpośrednio z pliku .pdb.
Aby zweryfikować plik .pdb pod kątem określonych kryteriów, użyj IDiaDataSourceEx::loadAndValidateDataFromPdbEx metody .
Aby uzyskać dostęp do procesu ładowania danych (za pomocą mechanizmu wywołania zwrotnego), użyj IDiaDataSourceEx::loadDataForExeEx metody .
Aby załadować plik .pdb bezpośrednio z pamięci, użyj IDiaDataSourceEx::loadDataFromIStreamEx metody .
Aby zweryfikować plik .pdb bez ładowania go, użyj IDiaDataSourceEx::ValidatePdb metody .
Przykład
HRESULT hr = pSource->loadDataFromPdbEx( L"myprog.pdb", TRUE );
if (FAILED(hr))
{
// report error
}