Dia2dump, exemple

  • Article

L’exemple Dia2dump montre comment utiliser le Kit de développement DIA (Debug Interface Access) pour rechercher des informations dans un fichier PDB.

L’exemple Dia2dump est installé avec Visual Studio et contient la solution et les fichiers sources. L’exécutable compilé s’exécute à partir de la ligne de commande. Il peut afficher le contenu d’un fichier de base de données de programme (.pdb) entier ou uniquement les sections qui vous intéressent.

Installer l’exemple

L’exemple s’installe quand vous choisissez la charge de travail Développement de bureau avec C++ dans Visual Studio Installer. Pour plus d’informations sur l’installation de Visual Studio et le choix de charges de travail spécifiques et de composants individuels, consultez Installer Visual Studio.

Quand il est installé, l’exemple se trouve dans le répertoire d’installation de Visual Studio, dans un sous-répertoire nommé \DIA SDK\Samples\DIA2Dump.

Générer l’exemple

Par défaut, le répertoire d’installation est protégé. Cela signifie que vous devez utiliser une instance de Visual Studio ou une invite de commandes développeur avec élévation de privilèges pour générer et modifier l’exemple de solution à cet emplacement. Pour simplifier la génération, nous vous recommandons de copier d’abord les fichiers du répertoire d’exemples dans un autre répertoire, par exemple votre dossier Documents, puis de générer l’exemple.

Pour générer l’exemple Dia2Dump dans Visual Studio

  1. Ouvrez le fichier DIA2Dump.sln dans Visual Studio. Si vous n’avez pas copié la solution dans un autre répertoire, vous serez peut-être invité à redémarrer Visual Studio avec des autorisations élevées.

  2. Dans l’Explorateur de solutions, sélectionnez le projet Dia2Dump (pas la solution).

  3. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Utilisation des propriétés de projet.

  4. Sélectionnez la page de propriétés Propriétés de configuration>C/C++>Général.

  5. Dans la propriété Autres répertoires Include, choisissez le contrôle de liste déroulante, puis choisissez Modifier.

  6. Dans la boîte de dialogue Autres répertoires Include, dans le champ de modification, entrez le répertoire $(VSInstallDir)DIA SDK\include. Ajoutez ce répertoire pour garantir que le compilateur peut trouver le fichier dia2.h. Choisissez OK pour enregistrer vos modifications.

  7. Choisissez OK pour enregistrer les modifications apportées aux propriétés du projet.

  8. Dans le menu Générer, choisissez Regénérer la solution. Par défaut, Visual Studio génère une version Debug de l’exemple, située dans un sous-répertoire Debug du répertoire de la solution.

  9. Fermez Visual Studio.

Pour générer l’exemple Dia2Dump à partir de la ligne de commande

  1. Dans une fenêtre d’invite de commandes développeur, accédez au répertoire dans lequel vous avez copié les exemples de fichiers. Si vous n’avez pas copié l’exemple dans un autre répertoire, vous devez utiliser une fenêtre d’invite de commandes développeur avec élévation de privilèges (exécuter en tant qu’administrateur).

  2. Entrez la commande nmake all pour générer la configuration Debug par défaut de dia2dump.exe.

Exécutez l’exemple Dia2dump

Dia2Dump.exe s’appuie sur le serveur COM msdiaversion.dll pour fournir ses services. À partir de Visual Studio 2015, la version est msdia140.dll. Si le serveur COM msdiaversion.dll n’est pas initialisé, vous devez d’abord l’inscrire pour que dia2dump.exe puisse fonctionner. Le répertoire du Kit de développement DIA inclut un sous-répertoire bin contenant la version x86 de la DLL. Une version pour les machines d’architecture x64 se trouve dans bin\amd64 et une version pour ARM se trouve dans bin\arm. Pour inscrire la dll, ouvrez une fenêtre d’invite de commandes développeur avec élévation de privilèges, puis accédez au répertoire qui contient la version d’architecture de votre machine. Entrez la commande regsvr32 msdia140.dll pour inscrire le serveur COM.

Exécution de l'exemple

  1. Ouvrez une invite de commandes et accédez au répertoire qui contient le fichier dia2dump.exe que vous avez généré.

  2. Entrez la commande dia2dump filename où filename est le nom d’un fichier PDB à examiner. Si le fichier PDB se trouve dans un autre répertoire, utilisez le chemin complet du fichier pour filename. Cette commande liste toutes les données du fichier PDB.

  3. Dia2Dump dispose d’autres options permettant d’afficher uniquement les informations sélectionnées. Utilisez la commande dia2dump -? pour lister toutes les options disponibles.

Voir aussi