Consumindo bibliotecas e componentes

Os projetos C++ geralmente precisam chamar funções ou acessar dados em um arquivo binário, como biblioteca estática (arquivos LIB), DLL, componente do Tempo de Execução do Windows, componente COM ou assembly .NET. Nesses casos, você tem que configurar o projeto para que ele possa encontrar esse binário no momento da compilação. As etapas específicas dependem do tipo do seu projeto, do tipo do binário e se o binário é construído na mesma solução que o seu projeto.

Consumindo bibliotecas baixadas via vcpkg

Para consumir uma biblioteca que você baixou usando o gerenciador de pacotes vcpkg , você pode ignorar as instruções abaixo. Para obter mais informações, consulte:

Consumindo bibliotecas estáticas

Se o seu projeto de biblioteca estática for criado na mesma solução:

#include o(s) arquivo(s) de cabeçalho para a biblioteca estática usando aspas. Em uma solução típica, o caminho começa com ../<library project name>. O IntelliSense vai ajudá-lo a encontrar.
Adicione uma referência ao projeto de biblioteca estática. Clique com o botão direito do mouse em Referências no nó do projeto de aplicativo no Gerenciador de Soluções e escolha Adicionar Referência.

Se a biblioteca estática não fizer parte da solução:

Clique com o botão direito do mouse no nó do projeto de aplicativo no Gerenciador de Soluções e escolha Propriedades.
Na página de propriedades Diretórios VC++ , adicione o caminho para o diretório que contém o arquivo LIB para Diretórios de biblioteca. Em seguida, adicione o caminho ao(s) arquivo(s) de cabeçalho da biblioteca para Incluir diretórios.
Na página de propriedades Entrada do vinculador>, adicione o nome do arquivo LIB a Dependências adicionais.

Bibliotecas de vínculo dinâmico

Se a DLL for criada como parte da mesma solução que o aplicativo, siga as mesmas etapas de uma biblioteca estática.

Se a DLL não fizer parte da solução do aplicativo, você precisará: o arquivo DLL, o(s) cabeçalho(s) com protótipos para as funções e classes exportadas e um arquivo LIB que forneça as informações de vinculação necessárias.

Copie a DLL para a pasta de saída do seu projeto ou para outra pasta no caminho de pesquisa padrão do Windows para DLLs. Para obter mais informações, consulte Dynamic-Link Ordem de pesquisa da biblioteca.
Siga as etapas 1 a 3 para bibliotecas estáticas para fornecer os caminhos para os cabeçalhos e o arquivo LIB.

Objetos COM

Se seu aplicativo C++ nativo precisa consumir um objeto COM, e esse objeto está registrado, então tudo o que você precisa fazer é chamar CoCreateInstance e passar o CLSID do objeto. O sistema irá encontrá-lo no Registro do Windows e carregá-lo. Um projeto C++/CLI pode consumir um objeto COM da mesma maneira. Ou, ele pode consumi-lo adicionando uma referência a ele a partir da lista Add References > COM e consumindo-o por meio de seu wrapper chamável Runtime.

Assemblies do .NET e Componentes da Runtime do Windows

Em projetos UWP ou C++/CLI, você consome assemblies .NET ou componentes do Windows Runtime ao adicionar uma referência ao assembly ou componente. No nó Referências em um projeto UWP ou C++/CLI, você verá referências a componentes comumente usados. Clique com o botão direito do mouse no nó Referências no Gerenciador de Soluções para exibir o Gerenciador de Referências e navegar pelos componentes disponíveis no sistema. Escolha o botão Procurar para navegar até qualquer pasta que contenha um componente personalizado. Como os assemblies .NET e os componentes do Tempo de Execução do Windows contêm informações de tipo internas, você pode exibir seus métodos e classes clicando com o botão direito do mouse e escolhendo Exibir no Pesquisador de Objetos.

Propriedades de referência

Cada tipo de referência tem propriedades. Você pode exibir as propriedades selecionando a referência no Gerenciador de Soluções e pressionando Alt + Enter, ou então clicando com o botão direito do mouse e escolhendo Propriedades. Algumas propriedades são somente leitura e outras são modificáveis. No entanto, normalmente não é necessário modificar manualmente essas propriedades.

Propriedades de referência ActiveX

As propriedades de referência ActiveX estão disponíveis apenas para referências a componentes COM. Essas propriedades são exibidas somente quando você seleciona um componente COM no painel Referências . As propriedades não são modificáveis.

Controle o caminho completo

Exibe o caminho do diretório do controle referenciado.
GUID de controle

Exibe o GUID para o controle ActiveX.
Versão de controle

Exibe a versão do controle ActiveX referenciado.
Digite o nome da biblioteca

Exibe o nome da biblioteca de tipos referenciada.
Ferramenta de Wrapper

Exibe a ferramenta utilizada para criar a assemblagem de interoperabilidade a partir do controle ActiveX ou da biblioteca COM referenciada.

Propriedades de referência de montagem (C++/CLI)

As propriedades de referência de assembly estão disponíveis apenas para referências a assemblies do .NET Framework em projetos C++/CLI. Essas propriedades são exibidas somente quando você seleciona um assembly do .NET Framework no painel Referências . As propriedades não são modificáveis.

Caminho relativo

Exibe o caminho relativo do diretório do projeto para o assembly referenciado.

Construir propriedades

As seguintes propriedades estão disponíveis em vários tipos de referências. Eles permitem que você especifique como criar com referências.

Copiar Localmente

Especifica se o assembly referenciado deve ser copiado automaticamente para o local de destino durante uma compilação.
Copiar Assemblagens Satélite Locais (C++/CLI)

Especifica se os assemblies satélite do assembly referenciado devem ser copiados automaticamente para o local de destino durante uma compilação. Usado apenas se Copy Local estiver true.
Saída de montagem de referência

Especifica que esse assembly é usado no processo de compilação. Se true, a assemblagem é utilizada na linha de comando do compilador durante o processo de construção.

Propriedades de referência de projeto a projeto

As propriedades a seguir definem uma referência de projeto para projeto do projeto selecionado no painel Referências para outro projeto na mesma solução. Para obter mais informações, consulte Gerenciando referências em um projeto.

Dependências da biblioteca de links

Quando essa propriedade é True, o sistema de projeto vincula os arquivos LIB que o projeto independente produz no projeto dependente. Normalmente, você especificará True.
Identificador do Projeto

Identifica exclusivamente o projeto independente. O valor da propriedade é um GUID do sistema interno que não é modificável.
Usar entradas de dependência de biblioteca

Quando essa propriedade é False, o sistema de projeto não vinculará os arquivos OBJ da biblioteca que o projeto independente produz ao projeto dependente. É por isso que esse valor desabilita a vinculação incremental. Normalmente, você especificará False porque a criação do aplicativo pode levar muito tempo se houver muitos projetos independentes.

Propriedades de referência de apenas leitura (COM & .NET)

As propriedades a seguir existem em referências de assembly COM e .NET e não são modificáveis.

Nome da compilação

Exibe o nome do conjunto para o conjunto referenciado.
Cultura

Exibe a cultura da referência selecionada.
Descrição

Exibe a descrição da referência selecionada.
Caminho Completo

Exibe o caminho do diretório do assembly referenciado.
Identidade

Para os assemblies do .NET Framework, exibe o caminho completo. Para componentes COM, exibe o GUID.
Rótulo

Exibe o rótulo da referência.
Nome

Exibe o nome da referência.
Token de chave pública

Exibe o token de chave pública usado para identificar a assemblagem referenciada.
Nome forte

true se o assembly referenciado tiver um nome forte. Uma assemblagem nomeada forte tem uma versão única.
Versão

Exibe a versão do assembly referenciado.

Ver também

Referência da página de propriedades do projeto C++
Definir compilador C++ e criar propriedades no Visual Studio

Comentários

Esta página foi útil?

Last updated on 2025-11-07