Condividi tramite

IDiaDataSourceEx::loadDataFromPdbEx

  • Articolo

Apre e prepara un file di database di programma (con estensione pdb) come origine dati di debug con prelettura di record facoltativa.

Sintassi

HRESULT loadDataFromPdbEx (
   LPCOLESTR pdbPath,
   BOOL      fPdbPrefetching
);

Parametri

pdbPath

[in] Percorso del file con estensione pdb.

fPdbPrefetching

[in] Se impostato su TRUE, i record di debug adiacenti vengono preletturati in memoria, sostituendo potenzialmente molte operazioni di I/O di file più piccole con meno operazioni di dimensioni maggiori e migliorando così la velocità effettiva complessiva man mano che tali record vengono successivamente accessibili, a scapito di un potenziale aumento dell'utilizzo della memoria. Se impostato su FALSE, questo comportamento si comporta in modo identico a IDiaDataSource::loadDataFromPdb. Se impostato su un altro valore, il comportamento non è specificato.

Valore restituito

Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore. Nella tabella seguente vengono illustrati i possibili valori restituiti per questo metodo.

valore Descrizione
E_PDB_NOT_FOUND Impossibile aprire il file o determinare che il file ha un formato non valido.
E_PDB_FORMAT Si è tentato di accedere a un file con un formato non compatibile o non supportato.
E_INVALIDARG Parametro non valido.
E_UNEXPECTED L'origine dati è già stata preparata.

Osservazioni:

Questo metodo carica i dati di debug direttamente da un file con estensione pdb.

Per convalidare il file con estensione pdb in base a criteri specifici, usare il IDiaDataSourceEx::loadAndValidateDataFromPdbEx metodo .

Per ottenere l'accesso al processo di caricamento dei dati (tramite un meccanismo di callback), usare il IDiaDataSourceEx::loadDataForExeEx metodo .

Per caricare un file con estensione pdb direttamente dalla memoria, usare il IDiaDataSourceEx::loadDataFromIStreamEx metodo .

Per convalidare un file con estensione pdb senza caricarlo, usare il IDiaDataSourceEx::ValidatePdb metodo .

Esempio

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

Vedi anche