IDiaDataSource::loadAndValidateDataFromPdb

  • Article

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

[entrée] Signature GUID à vérifier par rapport à la signature de 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 d’heure connue. Il est utilisé pour déterminer si un fichier .pdb n’est pas synchronisé avec un fichier .exe correspondant.

Valeur renvoyée

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 sans validation, utilisez la méthode IDiaDataSource::loadDataFromPdb.

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

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

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