Freigeben über

Dia2dump-Beispiel

  • Artikel

Im Dia2dump-Beispiel wird gezeigt, wie Sie mit dem MICROSOFT Debug Interface Access (DIA)-SDK eine PDB-Datei nach Informationen abfragen.

Das Dia2dump-Beispiel wird mit Visual Studio installiert und enthält die Projektmappen- und Quelldateien. Die kompilierte ausführbare Datei wird über die Befehlszeile ausgeführt. Sie kann den Inhalt einer ganzen PDB-Datei (Programmdatenbank) oder nur die Abschnitte anzeigen, die Sie interessieren.

Installieren des Beispiels

Das Beispiel wird installiert, wenn Sie die Workload Desktopentwicklung mit C++ im Visual Studio-Installer auswählen. Informationen zum Installieren von Visual Studio sowie zum Auswählen bestimmter Workloads und einzelner Komponenten finden Sie unter Installieren von Visual Studio.

Nach der Installation befindet sich das Beispiel in Ihrem Visual Studio-Installationsverzeichnis in einem Unterverzeichnis mit dem Namen „\DIA SDK\Samples\DIA2Dump“.

Erstellen des Beispiels

Standardmäßig ist das Installationsverzeichnis ein geschütztes Verzeichnis. Das bedeutet, dass Sie eine Developer-Eingabeaufforderung mit erhöhten Rechten oder eine Instanz von Visual Studio mit erhöhten Rechten verwenden müssen, um die Beispielprojektmappe an diesem Speicherort zu erstellen und zu bearbeiten. Um den Buildvorgang zu vereinfachen, empfiehlt es sich, zuerst die Dateien aus dem Beispielverzeichnis in ein anderes Verzeichnis zu kopieren, z. B. in einen Ordner in Ihrem Ordner „Dokumente“, und dann das Beispiel zu erstellen.

So erstellen Sie das Dia2Dump-Beispiel in Visual Studio

  1. Öffnen Sie die Datei „DIA2Dump.sln“ in Visual Studio. Wenn Sie die Lösung nicht in ein anderes Verzeichnis kopiert haben, werden Sie möglicherweise aufgefordert, Visual Studio mit erhöhten Berechtigungen neu zu starten.

  2. Wählen Sie im Projektmappen-Explorer das Dia2Dump-Projekt (nicht die Projektmappe) aus.

  3. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Working with Project Properties (Arbeiten mit Projekteigenschaften).

  4. Öffnen Sie die Eigenschaftenseite Konfigurationseigenschaften>C/C++>Allgemein.

  5. Wählen Sie in der Eigenschaft "Zusätzliche Includeverzeichnisse" das Dropdownlistensteuerelement und dann " Bearbeiten" aus.

  6. Geben Sie im Dialogfeld Zusätzliche Includeverzeichnisse im Feld „Bearbeiten“ das $(VSInstallDir)DIA SDK\include-Verzeichnis ein. Fügen Sie dieses Verzeichnis hinzu, um sicherzustellen, dass der Compiler die Datei „dia2.h“ finden kann. Klicken Sie auf OK, um die Änderungen zu speichern.

  7. Wählen Sie OK aus, um Ihre Änderungen an den Projekteigenschaften zu speichern.

  8. Wählen Sie im Menü Erstellen die Option Projektmappe neu erstellen aus. Standardmäßig erstellt Visual Studio eine Debugversion des Beispiels, die sich in einem Unterverzeichnis „Debug“ des Projektmappenverzeichnisses befindet.

  9. Schließen Sie Visual Studio.

So erstellen Sie das Dia2Dump-Beispiel über die Befehlszeile

  1. Wechseln Sie in einem Developer-Eingabeaufforderungsfenster zu dem Verzeichnis, in das Sie die Beispieldateien kopiert haben. Wenn Sie das Beispiel in kein anderes Verzeichnis kopiert haben, müssen Sie ein Developer-Eingabeaufforderungsfenster mit erhöhten Rechten (als Administrator ausgeführt) verwenden.

  2. Geben Sie den Befehl nmake all ein, um die Debugstandardkonfiguration von „dia2dump.exe“ zu erstellen.

Ausführen des Dia2Dump-Beispiels

„Dia2Dump.exe“ verwendet den COM-Server „msdiaVersion.dll“, um dessen Dienste bereitzustellen. Ab Visual Studio 2015 ist die Version „msdia140.dll“. Wenn der COM-Server „msdiaVersion.dll“ nicht initialisiert ist, müssen Sie ihn zuerst registrieren, damit „dia2dump.exe“ funktionieren kann. Das Verzeichnis „DIA SDK“ enthält ein Unterverzeichnis „bin“, das die x86-Version der DLL enthält. Eine Version für Computer mit X64-Architektur befindet sich in „bin\amd64“, und eine Version für ARM-Architekturen befindet sich in „bin\arm“. Um die DLL zu registrieren, öffnen Sie ein Developer-Eingabeaufforderungsfenster mit erhöhten Rechten und wechseln zu dem Verzeichnis, das die Version für Ihre Computerarchitektur enthält. Geben Sie den Befehl regsvr32 msdia140.dll ein, um den COM-Server zu registrieren.

So führen Sie das Beispiel aus

  1. Öffnen Sie eine Eingabeaufforderung, und wechseln Sie zu dem Verzeichnis, das die von Ihnen erstellte „dia2dump.exe“ enthält.

  2. Geben Sie den Befehl dia2dump filename ein, wobei Dateiname der Name einer zu untersuchenden PDB-Datei ist. Wenn sich die PDB-Datei in einem anderen Verzeichnis befindet, verwenden Sie den vollständigen Pfad zur Datei als Dateinamen. Dieser Befehl listet alle Daten in der PDB-Datei auf.

  3. Dia2Dump verfügt über weitere Optionen, um nur ausgewählte Informationen anzuzeigen. Verwenden Sie den Befehl dia2dump -?, um alle verfügbaren Optionen aufzulisten.

Weitere Informationen