Compartilhar via


Exemplo de Dia2dump

O exemplo Dia2dump mostra como usar o DIA SDK (Kit de Desenvolvimento de Software) de Acesso à Interface de Depuração da Microsoft para consultar um arquivo PDB para obter informações.

O exemplo Dia2dump é instalado com o Visual Studio e contém a solução e os arquivos de origem. O executável compilado é executado na linha de comando. Ele pode exibir o conteúdo de um arquivo de banco de dados de programa inteiro (.pdb) ou apenas as seções em que você está interessado.

Instalar o exemplo

O exemplo é instalado quando você escolhe a carga de trabalho Desenvolvimento da área de trabalho com C++ no Instalador do Visual Studio. Para obter informações sobre como instalar o Visual Studio e escolher cargas de trabalho específicas e componentes individuais, confira Instalar o Visual Studio.

Quando instalado, o exemplo está no diretório de instalação do Visual Studio, em um subdiretório chamado \DIA SDK\Samples\DIA2Dump.

Compilar o exemplo

Por padrão, o diretório de instalação é um diretório protegido. Isso significa que você precisa usar um prompt de comando do Desenvolvedor com privilégios elevados ou uma instância do Visual Studio para criar e editar a solução de exemplo neste local. Para simplificar o build, recomendamos que você primeiro copie os arquivos do diretório de exemplo para outro diretório, como uma pasta na pasta Documentos e, em seguida, compile o exemplo.

Para compilar o exemplo Dia2Dump no Visual Studio

  1. Abra o arquivo DIA2Dump.sln no Visual Studio. Se você não copiou a solução para outro diretório, você pode ser solicitado a reiniciar o Visual Studio com permissões elevadas.

  2. Em Gerenciador de Soluções, selecione o projeto Dia2Dump (não a solução).

  3. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Trabalhando com propriedades do projeto.

  4. Selecione a página de propriedades Propriedades de configuração>C/C++>Geral.

  5. Na propriedade Diretórios de Inclusão Adicionais, escolha o controle de lista suspensa e escolha Editar.

  6. Na caixa de diálogo Diretórios de Inclusão Adicionais, no campo editar, insira o diretório $(VSInstallDir)DIA SDK\include. Adicione esse diretório para garantir que o compilador possa localizar o arquivo dia2.h. Escolha OK para salvar suas alterações.

  7. Escolha OK para salvar suas alterações às propriedades do projeto.

  8. No menu Compilar, escolha Recompilar Solução. Por padrão, o Visual Studio cria uma versão de Depuração do exemplo, localizada em um subdiretório Depurar do diretório da solução.

  9. Feche o Visual Studio.

Para criar o exemplo Dia2Dump na linha de comando

  1. Em uma janela do prompt de comando do Desenvolvedor, altere para o diretório em que você copiou os arquivos de exemplo. Se você não copiou o exemplo para outro diretório, precisará usar uma janela de prompt de comando do desenvolvedor com privilégios elevados (executar como administrador).

  2. Insira o comando nmake all para compilar a configuração de depuração padrão de dia2dump.exe.

Executar o exemplo Dia2Dump

Dia2Dump.exe depende daversão do servidor COM msdia.dll para fornecer os próprios serviços. No Visual Studio 2015 e versões posteriores, a versão é msdia140.dll. Se o servidor COM msdiaversão.dll não for inicializado, você precisará registrá-lo antes que dia2dump.exe possa funcionar. O diretório do SDK do DIA tem um subdiretório bin que contém a versão x86 da DLL. Uma versão para computadores de arquitetura x64 está em bin\amd64 e uma versão para ARM está em bin\arm. Para registrar a dll, abra uma janela de prompt de comando do desenvolvedor com privilégios elevados e altere para o diretório que contém a versão da arquitetura do computador. Insira o comando regsvr32 msdia140.dll para registrar o servidor COM.

Para executar a amostra

  1. Abra um prompt de comando e altere para o diretório que contém o dia2dump.exe que você criou.

  2. Insira o comando dia2dump filename, em que filename é o nome de um arquivo PDB a ser examinado. Se o arquivo PDB estiver em outro diretório, use o caminho completo para o arquivo como filename. Esse comando lista todos os dados no arquivo PDB.

  3. Dia2Dump tem outras opções para exibir apenas as informações selecionadas. Use o comando dia2dump -? para listar todas as opções disponíveis.

Confira também