Freigeben über


IDiaDataSource::loadDataForExe

Öffnet die Debugdaten, die der .exe/.dll Datei zugeordnet sind, und bereitet sie vor.

Syntax

HRESULT loadDataForExe (
   LPCOLESTR executable,
   LPCOLESTR searchPath,
   IUnknown* pCallback
);

Parameter

executable

[in] Pfad zur .exe Datei..dll

searchPath

[in] Alternative Pfade zum Suchen nach Debugdaten. Mehrere Pfade sollten durch Semikolons getrennt sein. Pfade können einen nachgestellten \Pfad enthalten.

pCallback

[in] Eine IUnknown-Schnittstelle für ein Objekt, das eine Debugrückrufschnittstelle unterstützt, z. B. die Schnittstellen IDiaLoadCallback, IDiaLoadCallback2, IDiaReadExeAtOffsetCallback und/oder IDiaReadExeAtRVACallback.

Rückgabewert

Wenn die Ausführung erfolgreich ist, wird S_OK, andernfalls ein Fehlercode zurückgegeben. Die folgende Tabelle enthält einige der möglichen Fehlercodes dieser Methode.

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 vorbereitet.

Hinweise

Der Debugheader der .exe/.dll Dateinamen des zugeordneten Debugdatenspeicherorts.

Wenn Sie Debugdaten von einem Symbolserver laden, muss symsrv.dll im selben Verzeichnis vorhanden sein, in dem entweder die Anwendung des Benutzers oder msdia140.dll installiert ist, oder sie muss im Systemverzeichnis vorhanden sein.

Diese Methode liest den Debugheader, sucht dann nach den Debugdaten und bereitet sie vor. Der Fortschritt der Suche kann über Rückrufe gemeldet und gesteuert werden. Dies wird beispielsweise aufgerufen, wenn die IDiaLoadCallback::NotifyDebugDir IDiaDataSource::loadDataForExe Methode ein Debugverzeichnis findet und verarbeitet.

IDiaReadExeAtRVACallback Mit IDiaReadExeAtOffsetCallback den Schnittstellen kann die Clientanwendung alternative Methoden zum Lesen von Daten aus der ausführbaren Datei bereitstellen, wenn auf die Datei nicht direkt über Standarddatei-E/A zugegriffen werden kann.

Verwenden Sie die IDiaDataSourceEx::loadDataForExeEx Methode, um eine .pdb Datei mit dem Vorabfetching von Symboldatensätzen zu laden.

Verwenden Sie die IDiaDataSource::loadDataFromPdb Methode, um eine PDB-Datei ohne Überprüfung zu laden.

Verwenden Sie die IDiaDataSource::loadAndValidateDataFromPdb Methode, um die PDB-Datei anhand bestimmter Kriterien zu überprüfen.

Verwenden Sie die Methode, um eine PDB-Datei direkt aus dem IDiaDataSource::loadDataFromIStream Arbeitsspeicher zu laden.

Verwenden Sie die Methode, um eine PDB-Datei zu überprüfen, ohne sie IDiaDataSourceEx::ValidatePdb zu laden.

Beispiel

class MyCallBack: public IDiaLoadCallback
{
...
};
MyCallBack callback;
...
HRESULT hr = pSource->loadDataForExe( L"myprog.exe", L".\debug", (IUnknown*)&callback);
if (FAILED(hr))
{
    // Report error
}

Siehe auch