Partager via


IDiaDataSource::loadAndValidateDataFromPdb

Ouvre et vérifie que le fichier de base de données du programme (.pdb) correspond aux informations de signature fournies et prépare le fichier .pdb en tant que source de données de débogage.

Syntaxe

HRESULT loadAndValidateDataFromPdb ( 
   LPCOLESTR pdbPath,
   GUID*     pcsig70,
   DWORD     sig,
   DWORD     age
);

Paramètres

pdbPath

[entrée] Chemin d’accès au fichier .pdb.

pcsig70

[in] Signature d’identificateur global unique (GUID) à vérifier par rapport à la signature du fichier .pdb. Seuls les fichiers .pdb dans Visual C++ et versions ultérieures ont des signatures GUID.

sig

[entrée] Signature 32 bits à vérifier par rapport à la signature de fichier .pdb.

age

[entrée] Valeur d’âge à vérifier. L’âge ne correspond pas nécessairement à une valeur de temps connue, il est utilisé pour déterminer si un fichier .pdb n’est pas synchronisé avec un fichier .exe correspondant.

Valeur de retour

En cas de réussite, retourne S_OK , sinon, retourne un code d'erreur. Le tableau suivant montre les valeurs possibles pour cette méthode.

Valeur Description
E_PDB_NOT_FOUND Impossible d’ouvrir le fichier, ou fichier de format non valide.
E_PDB_FORMAT Tentative d’accès à un fichier dont le format est obsolète.
E_PDB_INVALID_SIG La signature ne correspond pas.
E_PDB_INVALID_AGE L’âge ne correspond pas.
E_INVALIDARG Paramètre non valide.
E_UNEXPECTED La source de données a déjà été préparée.

Notes

Un fichier .pdb contient des valeurs de signature et d’âge. Ces valeurs sont répliquées dans le fichier .exe ou .dll qui correspond au fichier .pdb. Avant de préparer la source de données, cette méthode vérifie que la signature et l’âge du fichier .pdb nommé correspondent aux valeurs fournies.

Pour charger un fichier .pdb et valider avec la prérécupération, utilisez la IDiaDataSourceEx::loadAndValidateDataFromPdbEx méthode.

Pour charger un fichier .pdb sans validation, utilisez la IDiaDataSource::loadDataFromPdb méthode.

Pour accéder au processus de chargement des données (via un mécanisme de rappel), utilisez la IDiaDataSource::loadDataForExe méthode.

Pour charger un fichier .pdb directement à partir de la mémoire, utilisez la IDiaDataSource::loadDataFromIStream méthode.

Pour valider un fichier .pdb sans le charger, utilisez la IDiaDataSourceEx::ValidatePdb méthode.

Exemple

IDiaDataSource* pSource;  // Previously created data source.
DEFINE_GUID(expectedGUIDSignature,0x1234,0x5678,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08);
DWORD expectedFileSignature = 0x12345678;
DWORD expectedAge           = 128;

HRESULT hr;
hr = pSource->loadAndValidateDataFromPdb( L"yprog.pdb",
                                          &expectedGUIDSignature,
                                          expectedFileSignature,
                                          expectedAge);
if (FAILED(hr))
{
    // Report an error
}

Voir aussi