IDiaDataSource::loadAndValidateDataFromPdb
Öffnet die Programmdatenbankdatei (.pdb), und überprüft, ob sie mit den angegebenen Signaturinformationen übereinstimmt, und bereitet die PDB-Datei dann als Debugdatenquelle vor.
Syntax
HRESULT loadAndValidateDataFromPdb (
LPCOLESTR pdbPath,
GUID* pcsig70,
DWORD sig,
DWORD age
);
Parameter
pdbPath
[in] Der Pfad zur PDB-Datei.
pcsig70
[in] Die GUID-Signatur, die anhand der PDB-Dateisignatur überprüft werden soll. Nur PDB-Dateien in Visual C++ und höher verfügen über GUID-Signaturen.
sig
[in] Die 32-Bit-Signatur, die anhand der PDB-Dateisignatur überprüft werden soll.
age
[in] Der Alterswert, der überprüft werden soll. Das Alter entspricht nicht unbedingt einem bekannten Zeitwert, sondern wird verwendet, um festzustellen, ob eine PDB-Datei nicht mit einer entsprechenden EXE-Datei synchronisiert ist.
Rückgabewert
Wenn die Ausführung erfolgreich ist, wird S_OK
, andernfalls ein Fehlercode zurückgegeben. In der folgenden Tabelle werden die möglichen Rückgabewerte für diese Methode angezeigt.
Wert | BESCHREIBUNG |
---|---|
E_PDB_NOT_FOUND | Fehler beim Öffnen der Datei, oder die Datei weist ein ungültiges Format auf. |
E_PDB_FORMAT | Es wurde versucht, auf eine Datei mit einem veralteten Format zuzugreifen. |
E_PDB_INVALID_SIG | Die Signatur stimmt nicht überein. |
E_PDB_INVALID_AGE | Das Alter stimmt nicht überein. |
E_INVALIDARG | Ungültiger Parameter. |
E_UNEXPECTED | Die Datenquelle wurde bereits aufbereitet. |
Bemerkungen
Eine PDB-Datei enthält sowohl Signatur- als auch Alterswerte. Diese Werte werden in der EXE- oder DLL-Datei repliziert, die der PDB-Datei entspricht. Bevor Sie die Datenquelle vorbereiten, überprüft diese Methode, ob die Signatur und das Alter der benannten PDB-Datei mit den angegebenen Werten übereinstimmen.
Um eine PDB-Datei ohne Validierung zu laden, verwenden Sie die IDiaDataSource::loadDataFromPdb-Methode.
Um Zugriff auf den Datenladevorgang zu erhalten (über einen Rückrufmechanismus), verwenden Sie die IDiaDataSource::loadDataForExe-Methode.
Um eine PDB-Datei direkt aus dem Speicher zu laden, verwenden Sie die IDiaDataSource::loadDataFromIStream-Methode.
Beispiel
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
}
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für