Compartir a través de


Cómo compilar ejemplos

Para compilar un ejemplo COM, el entorno de equipo debe configurarse para compilar aplicaciones de C++ de Microsoft Win32.

Preparar un equipo para crear ejemplos COM

El entorno del equipo debe configurarse con un compilador de C++ de 32 bits instalado correctamente, enlazador y compilador de recursos que sean compatibles con Microsoft Visual C++ 4.x o posterior y un SDK de Windows instalado correctamente. Es mejor instalar windows SDK por última vez. Windows SDK proporciona archivos de biblioteca .h y .lib necesarios para la funcionalidad COM codificada en los ejemplos.

Para ejecutar correctamente los ejemplos de Remclien, Freserve y Freclien, se necesitan instalaciones del sistema disponibles en los sistemas operativos Windows: Windows Server 2003, Windows XP, Windows 2000 o Windows NT 4.0. Los ejemplos de Remclien, Freserve y Freclien se compilarán, pero no se ejecutarán en los sistemas operativos Windows Me, Windows 98 o Windows 95 a menos que Distributed COM (DCOM) y COM libre de subprocesos formen parte del sistema operativo. Esta compatibilidad está disponible para los sistemas operativos Windows Me, Windows 98 y Windows 95 en el complemento DCOM95.

Cada directorio de ejemplo tiene los archivos de origen necesarios para compilar y ejecutar el ejemplo. El directorio de ejemplo primario tiene un archivo Makeall.bat, que puede ejecutar desde el símbolo del sistema para realizar todos los ejemplos de código de la rama siguiente. Para obtener más información, vea el archivo Makeall.bat. Si el entorno está configurado para compilar aplicaciones de C++ win32, simplemente puede ejecutar Makeall.bat desde el directorio donde reside para compilar todos los ejemplos de código de la rama siguiente. Makeall garantiza el orden correcto de la compilación para que se cumplan todas las dependencias del ejemplo de código.

El directorio principal también tiene un archivo Make que compila todos los ejemplos de código del tutorial mediante opciones similares a las admitidas por Makeall.bat. Para obtener más información, vea este archivo make. En este archivo make se da por supuesto que toda la rama de ejemplos de código está instalada como parte de Windows SDK. Actualmente, esta ubicación tiene una ruta de acceso similar a D:\MSSDK\SAMPLES\COM\TUTSAMP, donde D: representa la unidad de instalación. Si ha extraído la rama de ejemplo de código del tutorial (por ejemplo, el directorio COM COM y sus subdirectorios) en otra ubicación fuera de Windows SDK (o si obtuvo el conjunto de ejemplo como una descarga independiente del sitio web de Microsoft), use Makeall.bat para compilar todos los ejemplos de la rama. En general, se recomienda Makeall.bat. También se proporciona un archivo Logmall.bat. Hace lo mismo que el archivo por lotes Makeall, salvo que registra toda la salida de compilación en el archivo Errorlog.txt en el directorio del tutorial principal.

También se proporcionan dos archivos por lotes, Regall.bat y Unregall.bat, en el directorio principal para registrar y anular el registro de todos los servidores COM de la serie de ejemplo de código del tutorial. Para registrar todos los servidores, ejecute Regall.bat archivo desde el directorio principal. Para anular el registro de todos los servidores, ejecute Unregall.bat de la misma manera. Estos archivos por lotes requieren una compilación anterior de los ejemplos de código REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE y CONSERVE. Si realiza una compilación normal de los ejemplos de código, los archivos make del servidor registrarán automáticamente los servidores. En este caso, no es necesario ejecutar el archivo por lotes Regall.

Ejecute el archivo por lotes Cleanall.bat para realizar una limpieza exhaustiva de todos los ejemplos del tutorial de COM.

Advertencia

Este archivo por lotes elimina todos los archivos de proyecto de Visual Studio y otros archivos de trabajo temporales creados por Visual C++ en los ejemplos. Todos los servidores COM integrados en los ejemplos de código del tutorial no se registran en el registro. Se eliminan todos los archivos ejecutables exe y .dll. Se eliminan todos los archivos de símbolos de depuración. También se eliminan los archivos generados en diversos entornos de compilación.

 

Ejecute "Makeall Clean" para realizar una limpieza más rápida, pero más modesta de todos los ejemplos de código. Esta operación de limpieza no intenta ser tan completa como la realizada por Cleanall.bat. Los archivos .obj se eliminan, pero los archivos binarios de salida se conservan. Los servidores COM no se registran en el registro.

Esta serie de ejemplo se originó como parte integral de Windows SDK, por lo que la narrativa del tutorial supone un entorno con Windows SDK correctamente instalado.

Sin embargo, las versiones de Microsoft Visual C++ versión 4.0 y posteriores también pueden proporcionar los archivos de biblioteca .h include y .lib necesarios para la compilación. En tales casos, es posible que no sea necesario instalar Windows SDK para compilar los ejemplos.

Para obtener más información y completar los detalles de compilación de ejemplo, consulte:

Configuración del entorno

Makefiles

Uso de Visual Studio

Extracción de los ejemplos de código

Convenciones de estilo de codificación