Tutorial: Crear y utilizar una biblioteca de vínculos dinámicos (C++)

Artículo
06/10/2015

Este tutorial paso a paso muestra cómo crear una biblioteca de vínculos dinámicos (DLL) para su uso con aplicaciones de C++. Utilizar una biblioteca es una excelente manera de reutilizar código. En lugar de volver a implementar las mismas rutinas en cada programa que crea, las escribe una vez y, luego, hace referencia a ellas desde las aplicaciones que requieren esa funcionalidad. Al colocar el código en la DLL, ahorra espacio en cada aplicación que hace referencia a ella y puede actualizar la DLL sin tener que recompilar todas las aplicaciones. Para más información sobre las DLL, consulte Archivos DLL en Visual C++.

En este tutorial se tratan las siguientes tareas:

Creación de un proyecto de DLL
Adición de una clase a la DLL
Creación de una aplicación de consola que usa vinculación dinámica en tiempo de carga para hacer referencia a la DLL
Uso de la funcionalidad desde la clase de la aplicación
Ejecución de la aplicación

En este tutorial, se crea una DLL a la que solo se puede llamar desde las aplicaciones que utilizan las convenciones de llamada de C++. Para obtener información sobre cómo crear DLL que se puedan usar con otros lenguajes, consulte Llamar a funciones de un archivo DLL desde aplicaciones programadas en Visual Basic.

Requisitos previos

En este tema, se da por supuesto que comprende los fundamentos del lenguaje C++.

Para crear un proyecto de biblioteca de vínculos dinámicos (DLL)

En la barra de menús, elija Archivo, Nuevo, Proyecto.
En el panel de la izquierda del cuadro de diálogo Nuevo proyecto, expanda Instalado, Plantillas, Visual C++ y, a continuación, seleccione Win32.
En el panel central, seleccione Aplicación de consola Win32.
Especifique un nombre para el proyecto en el cuadro Nombre: por ejemplo, MathFuncsDll. Especifique un nombre para la solución en el cuadro Nombre de la solución: por ejemplo, DynamicLibrary. Elija el botón Aceptar.
En la página Información general del cuadro de diálogo Asistente para aplicaciones Win32, elija el botón Siguiente.
En la página Configuración de la aplicación, en Tipo de aplicación, seleccione DLL.
Elija el botón Finalizar para crear el proyecto.

Para agregar una clase a la biblioteca de vínculos dinámicos

Para crear un archivo de encabezado para una nueva clase, en la barra de menús, elija Proyecto, Agregar nuevo elemento. En el cuadro de diálogo Agregar nuevo elemento, en el panel izquierdo, bajo Visual C++, seleccione Código. En el panel central, seleccione Archivo de encabezado (.h). Especifique un nombre para el archivo de encabezado (por ejemplo, MathFuncsDll.h) y, después, elija el botón Agregar. Se muestra un archivo de encabezado en blanco.

Agregue el siguiente código a la parte superior del archivo de encabezado:

// MathFuncsDll.h

#ifdef MATHFUNCSDLL_EXPORTS
#define MATHFUNCSDLL_API __declspec(dllexport) 
#else
#define MATHFUNCSDLL_API __declspec(dllimport) 
#endif

Agregue una clase básica llamada MyMathFuncs para realizar operaciones matemáticas comunes, como suma, resta, multiplicación y división. El código debe ser similar a este:
```
namespace MathFuncs
{
    // This class is exported from the MathFuncsDll.dll
    class MyMathFuncs
    {
    public: 
        // Returns a + b
        static MATHFUNCSDLL_API double Add(double a, double b); 

        // Returns a - b
        static MATHFUNCSDLL_API double Subtract(double a, double b); 

        // Returns a * b
        static MATHFUNCSDLL_API double Multiply(double a, double b); 

        // Returns a / b
        // Throws const std::invalid_argument& if b is 0
        static MATHFUNCSDLL_API double Divide(double a, double b); 
    };
}
```
Cuando el símbolo MATHFUNCSDLL_EXPORTS está definido, el símbolo MATHFUNCSDLL_API establece el modificador __declspec(dllexport) en las declaraciones de funciones miembros de este código. Este modificador permite que la DLL exporte la función para que otras aplicaciones puedan usarla. Cuando MATHFUNCSDLL_EXPORTS está sin definir (por ejemplo, cuando es una aplicación la que incluye el archivo de encabezado), MATHFUNCSDLL_API define el modificador __declspec(dllimport) en las declaraciones de funciones miembros. Este modificador optimiza la importación de la función en una aplicación. De forma predeterminada, la plantilla Nuevo proyecto de una DLL agrega PROJECTNAME_EXPORTS a los símbolos definidos del proyecto de DLL. En este ejemplo, MATHFUNCSDLL_EXPORTS se define al compilar el proyecto MathFuncsDll. Para obtener más información, vea dllexport, dllimport.

Nota

Si compila el proyecto de DLL en la línea de comandos, utilice la opción del compilador /D para definir el símbolo MATHFUNCSDLL_EXPORTS.
En el proyecto MathFuncsDll, en el Explorador de soluciones, dentro de la carpeta Archivos de código fuente, abra MathFuncsDll.cpp.

Implemente la funcionalidad de MyMathFuncs en el código fuente. El código debe ser similar a este:

// MathFuncsDll.cpp : Defines the exported functions for the DLL application. 
//

#include "stdafx.h"
#include "MathFuncsDll.h"
#include <stdexcept>

using namespace std;

namespace MathFuncs
{
    double MyMathFuncs::Add(double a, double b)
    {
        return a + b;
    }

    double MyMathFuncs::Subtract(double a, double b)
    {
        return a - b;
    }

    double MyMathFuncs::Multiply(double a, double b)
    {
        return a * b;
    }

    double MyMathFuncs::Divide(double a, double b)
    {
        if (b == 0)
        {
            throw invalid_argument("b cannot be zero!");
        }

        return a / b;
    }
}

Compile la biblioteca de vínculos dinámicos eligiendo Compilar, Compilar solución en la barra de menús.

Nota

Si está utilizando una edición Express que no muestre el menú Compilar, en la barra de menús, elija Herramientas, Configuración, Configuración para expertos para habilitarlo y, luego, elija Compilar, Compilar solución.

Nota

Si compila un proyecto desde la línea de comandos, utilice la opción del compilador /LD para especificar que el archivo de salida debe ser una DLL.Para obtener más información, vea /MD, /MT, /LD (Utilizar la biblioteca en tiempo de ejecución).Utilice la opción del compilador /EHsc para habilitar el control de excepciones de C++.Para obtener más información, vea /EH (Modelo de control de excepciones).

Para crear una aplicación que haga referencia a la DLL

Para crear una aplicación de C++ que haga referencia a la DLL que acaba de crear y la utilice, en la barra de menús, elija Archivo, Nuevo, Proyecto.
En el panel izquierdo, debajo de Visual C++, seleccione Win32.
En el panel central, seleccione Aplicación de consola Win32.
Especifique un nombre para el proyecto en el cuadro Nombre: por ejemplo, MyExecRefsDll. Junto a Solución, seleccione Agregar a solución en la lista desplegable. De este modo, agregará el nuevo proyecto a la solución que contiene la DLL. Elija el botón Aceptar.
En la página Información general del cuadro de diálogo Asistente para aplicaciones Win32, elija el botón Siguiente.
En la página Configuración de la aplicación, en Tipo de aplicación, seleccione Aplicación de consola.
En la página Configuración de la aplicación, en Opciones adicionales, desactive la casilla Encabezado precompilado.
Elija el botón Finalizar para crear el proyecto.

Para utilizar la funcionalidad de la biblioteca de clases en la aplicación

Después de crear una aplicación de consola, se crea un programa vacío. El nombre del archivo de código fuente será el mismo que el elegido anteriormente. En este ejemplo, se llama MyExecRefsDll.cpp.
Para usar en la aplicación las rutinas matemáticas que creó en la DLL, debe hacer referencia a ellas. Para ello, seleccione el proyecto MyExecRefsDll en el Explorador de soluciones y, luego, en la barra de menús, elija Proyecto, Referencias. En el cuadro de diálogo Páginas de propiedades, expanda el nodo Propiedades comunes, seleccione Marco de trabajo y referencias y, después, elija el botón Agregar nueva referencia. Para obtener más información sobre el cuadro de diálogo Referencias, vea Marco de trabajo y referencias, Propiedades comunes, Páginas de propiedades de <nombreDeProyecto> (Cuadro de diálogo).
El cuadro de diálogo Agregar referencia muestra las bibliotecas a las que puede hacer referencia. La pestaña Proyectos muestra una lista de los proyectos de la solución actual y las bibliotecas que contienen. En la pestaña Proyectos, active la casilla situada junto a MathFuncsDll y, después, elija el botón Aceptar.
Para hacer referencia a los archivos de encabezado de la DLL, debe modificar la ruta de acceso de los directorios de inclusión. Para ello, en el cuadro de diálogo Páginas de propiedades, expanda el nodo Propiedades de configuración, expanda el nodo C/C++ y, luego, seleccione General. Junto a Directorios de inclusión adicionales, especifique la ruta de acceso de la ubicación donde se encuentra el archivo de encabezado MathFuncsDll.h. Puede usar una ruta de acceso relativa (por ejemplo, ..\MathFuncsDll\) y, después, elegir el botón Aceptar.

Ahora puede utilizar la clase MyMathFuncs en esta aplicación. Reemplace el contenido de MyExecRefsDll.cpp por el código siguiente:

// MyExecRefsDll.cpp 
// compile with: /EHsc /link MathFuncsDll.lib

#include <iostream>

#include "MathFuncsDll.h" 

using namespace std;

int main()
{
    double a = 7.4;
    int b = 99;

    cout << "a + b = " <<
        MathFuncs::MyMathFuncs::Add(a, b) << endl;
    cout << "a - b = " <<
        MathFuncs::MyMathFuncs::Subtract(a, b) << endl;
    cout << "a * b = " <<
        MathFuncs::MyMathFuncs::Multiply(a, b) << endl;
    cout << "a / b = " <<
        MathFuncs::MyMathFuncs::Divide(a, b) << endl;

    try
    {
        cout << "a / 0 = " <<
            MathFuncs::MyMathFuncs::Divide(a, 0) << endl; 
    }
    catch (const invalid_argument &e) 
    {
        cout << "Caught exception: " << e.what() << endl; 
    }

    return 0;
}

Compile el archivo ejecutable; para ello, elija Compilación, Compilar solución en la barra de menús.

Para ejecutar la aplicación

Compruebe que MyExecRefsDll está seleccionado como proyecto predeterminado. En el Explorador de soluciones, seleccione MyExecRefsDll y, luego, en la barra de menús, elija Proyecto, Establecer como proyecto de inicio.
Para ejecutar el proyecto, en la barra de menús, elija Depurar, Iniciar sin depurar. El resultado debería ser similar a lo siguiente:

a + b = 106,4 a - b = -91,6 a * b = 732,6 a / b = 0,0747475 Se detectó una excepción: b no puede ser cero.

Vea también

Compartir a través de

Tutorial: Crear y utilizar una biblioteca de vínculos dinámicos (C++)

Requisitos previos

Para crear un proyecto de biblioteca de vínculos dinámicos (DLL)

Para agregar una clase a la biblioteca de vínculos dinámicos

Para crear una aplicación que haga referencia a la DLL

Para utilizar la funcionalidad de la biblioteca de clases en la aplicación

Para ejecutar la aplicación

Vea también

Tareas

Conceptos

Otros recursos

Recursos adicionales