DLLs (C++/CX)

Você pode usar o Visual Studio para criar uma DLL Win32 padrão ou uma DLL de componente do Tempo de Execução do Windows que pode ser consumida por aplicativos da Plataforma Universal do Windows (UWP). Uma DLL padrão que foi criada usando uma versão do Visual Studio ou o compilador Microsoft C++ anterior ao Visual Studio 2012 pode não carregar corretamente em um aplicativo UWP e pode não passar no teste de verificação de aplicativo na Microsoft Store.

DLLs do componente do Tempo de Execução do Windows

Em quase todos os casos, quando você deseja criar uma DLL para uso em um aplicativo UWP, crie-a como um componente do Tempo de Execução do Windows usando o modelo de projeto com esse nome. Você pode criar um projeto de componente do Tempo de Execução do Windows para DLLs que tenham tipos de Tempo de Execução do Windows públicos ou privados. Um componente do Tempo de Execução do Windows pode ser acessado de aplicativos escritos em qualquer linguagem compatível com o Tempo de Execução do Windows. Por padrão, as configurações do compilador para um projeto de componente do Tempo de Execução do Windows usam a opção /ZW . Um arquivo .winmd deve ter o mesmo nome que o namespace raiz. Por exemplo, uma classe chamada A.B.C.MyClass pode ser instanciada somente se for definida em um arquivo de metadados chamado A.winmd ou A.B.winmd ou A.B.C.winmd. O nome da DLL não é necessário para corresponder ao nome do arquivo .winmd.

Para obter mais informações, consulte Criando componentes do Tempo de Execução do Windows em C++.

Para fazer referência a um binário de componente do Tempo de Execução do Windows de terceiros em seu projeto

1. Abra o menu de atalho para o projeto que usará a DLL e, em seguida, escolha Propriedades. Na página Propriedades comuns , escolha o botão Adicionar nova referência .

2. Um componente do Tempo de Execução do Windows consiste em um arquivo DLL e um arquivo .winmd que contém os metadados. Normalmente, esses arquivos estão localizados na mesma pasta. No painel esquerdo da caixa de diálogo Adicionar Referência , escolha o botão Procurar e navegue até o local da DLL e seu arquivo .winmd. Para obter mais informações, consulte SDKs de extensão.

DLLs padrão

Você pode criar uma DLL padrão para código C++ que não consuma ou produza tipos públicos do Tempo de Execução do Windows e consumi-la de um aplicativo UWP. Use o tipo de projeto Biblioteca Dynamic-Link (DLL) quando quiser apenas migrar uma DLL existente para compilar nesta versão do Visual Studio, mas não converter o código em um projeto de componente do Tempo de Execução do Windows. Quando você usa as etapas a seguir, a DLL será implantada junto com o executável do aplicativo no pacote .appx.

Para criar uma DLL padrão no Visual Studio

1. Na barra de menus, escolha Arquivo, Novo, Projeto e selecione o modelo de Biblioteca de Vínculo Dinâmico (DLL ).

2. Insira um nome para o projeto e escolha o botão OK .

3. Adicione o código. Certifique-se de usar __declspec(dllexport) para funções que você pretende exportar, por exemplo, __declspec(dllexport) Add(int I, in j);

4. Adicione #include winapifamily.h para incluir esse arquivo de cabeçalho do SDK do Windows para aplicativos UWP e defina a macro WINAPI_FAMILY=WINAPI_PARTITION_APP.

Para fazer referência a um projeto DLL padrão da mesma solução

1. Abra o menu de atalho para o projeto que usará a DLL e, em seguida, escolha Propriedades. Na página Propriedades comuns , escolha o botão Adicionar nova referência .

2. No painel esquerdo, selecione Solução e, em seguida, marque a caixa de seleção apropriada no painel direito.

3. Em seus arquivos de código-fonte, adicione uma #include instrução para o arquivo de cabeçalho DLL, conforme necessário.

Para fazer referência a um binário DLL padrão

1. Copie o arquivo DLL, o arquivo .lib e o arquivo de cabeçalho e cole-os em um local conhecido, por exemplo, na pasta do projeto atual.

2. Abra o menu de atalho para o projeto que usará a DLL e, em seguida, escolha Propriedades. Na página Propriedades de Configuração, Vinculador, Entrada , adicione o arquivo .lib como uma dependência.

3. Em seus arquivos de código-fonte, adicione uma #include instrução para o arquivo de cabeçalho DLL, conforme necessário.

Para migrar uma DLL Win32 existente para compatibilidade de aplicativos UWP

1. Crie um projeto do tipo DLL (Universal Windows) e adicione seu código-fonte existente a ele.

2. Adicione #include winapifamily.h para incluir esse arquivo de cabeçalho do SDK do Windows para aplicativos UWP e defina a macro WINAPI_FAMILY=WINAPI_PARTITION_APP.

3. Em seus arquivos de código-fonte, adicione uma #include instrução para o arquivo de cabeçalho DLL, conforme necessário.