Ejemplo Dia2dump

  • Artículo

En el ejemplo Dia2dump se muestra cómo usar el Kit de desarrollo de software de acceso de interfaz de depuración (SDK DIA) para consultar un archivo PDB para obtener información.

El ejemplo Dia2dump se instala con Visual Studio y contiene la solución y los archivos de origen. El ejecutable compilado se ejecuta desde la línea de comandos. Puede mostrar el contenido de un archivo completo de base de datos de programa (.pdb) o simplemente las secciones que le interesan.

Instalación del ejemplo

El ejemplo se instala como parte de la carga de trabajo Desarrollo de escritorio con C++ en el Instalador de Visual Studio. Para obtener información sobre cómo instalar Visual Studio y elegir cargas de trabajo específicas y componentes individuales, consulte Instalación de Visual Studio.

Cuando se instala, el ejemplo se encuentra en el directorio de instalación de Visual Studio, en un subdirectorio denominado \DIA SDK\Samples\DIA2Dump.

Compilación del ejemplo

De forma predeterminada, el directorio de instalación es un directorio protegido. Esto significa que debe usar un símbolo del sistema para desarrolladores con privilegios elevados o una instancia de Visual Studio para compilar y editar la solución de ejemplo en esta ubicación. Para simplificar la compilación, se recomienda copiar primero los archivos del directorio de ejemplo en otro directorio, como una carpeta de la carpeta Documentos y, a continuación, compilar el ejemplo.

Para compilar el ejemplo Dia2Dump en Visual Studio

  1. Abra el archivo DIA2Dump.sln en Visual Studio. Si no ha copiado la solución en otro directorio, es posible que se le pida que reinicie Visual Studio con permisos elevados.

  2. En Explorador de soluciones, seleccione el proyecto Dia2Dump (no la solución).

  3. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para obtener más información, vea Trabajar con propiedades del proyecto.

  4. Seleccione la página de propiedades Propiedades de configuración>C/C++>General.

  5. En la propiedad Directorios de inclusión adicionales, elija el control de lista desplegable y, a continuación, elija Editar.

  6. En el cuadro de diálogo Directorios de inclusión adicionales, en el campo de edición, introduzca el directorio $(VSInstallDir)DIA SDK\include. Agregue este directorio para garantizar que el compilador pueda encontrar el archivo dia2.h. Elija Aceptar para guardar los cambios.

  7. Elija Aceptar para guardar los cambios en las propiedades del proyecto.

  8. En el menú Compilar, elija Recompilar solución. De forma predeterminada, Visual Studio crea una versión de depuración del ejemplo, que se encuentra en un subdirectorio de depuración del directorio de la solución.

  9. Cierre Visual Studio.

Para compilar el ejemplo Dia2Dump en la línea de comandos

  1. En una ventana del símbolo del sistema para desarrolladores, cambie al directorio donde copió los archivos de ejemplo. Si no ha copiado el ejemplo en otro directorio, debe usar una ventana de símbolo del sistema del desarrollador con privilegios elevados (ejecutar como administrador).

  2. Escriba el comando nmake all para compilar la configuración de depuración predeterminada de dia2dump.exe.

Ejecución del ejemplo Dia2Dump

Dia2Dump.exe se basa en laversión.dll del servidor COM para proporcionar sus servicios. A partir de Visual Studio 2015, la versión es msdia140.dll. Si laversión msdia.dll servidor COM no se inicializa, debe registrarla para que dia2dump.exe pueda funcionar. El directorio Debug Interface Access SDK tiene un subdirectorio bin que contiene la versión x86 del archivo DLL. Una versión de las máquinas de arquitectura x64 está en bin\amd64, y una versión de ARM está en bin\arm. Para registrar el archivo DLL, abra una ventana de símbolo del sistema para desarrolladores con privilegios elevados y cambie al directorio que contiene la versión de la arquitectura de la máquina. Escriba el comando regsvr32 msdia140.dll para registrar el servidor COM.

Para ejecutar el ejemplo

  1. Abra un símbolo del sistema y cambie al directorio que contiene el dia2dump.exe que ha creado.

  2. Escriba el comando dia2dump filename donde filename es el nombre de un archivo PDB que se va a examinar. Si el archivo PDB está en otro directorio, use la ruta de acceso completa al archivo como nombre de archivo. Este comando enumera todos los datos del archivo PDB.

  3. Dia2Dump tiene otras opciones para mostrar solo la información seleccionada. Use el comando dia2dump -? para enumerar todas las opciones disponibles.

Vea también