Comment créer des exemples
Pour générer un exemple COM, l’environnement informatique doit être configuré pour générer des applications Microsoft Win32 C++.
Préparation d’un ordinateur à la création d’exemples COM
L’environnement de l’ordinateur doit être configuré avec un compilateur C++ 32 bits correctement installé, un éditeur de liens et un compilateur de ressources compatibles avec Microsoft Visual C++ 4.x ou version ultérieure, et un SDK Windows correctement installé. Il est préférable d’installer le SDK Windows en dernier. Le Kit de développement logiciel (SDK) Windows fournit les fichiers de bibliothèque .h include et .lib requis pour la fonctionnalité COM codée dans les exemples.
Pour exécuter correctement les exemples Remclien, Freserve et Freclien, vous devez disposer de fonctionnalités système disponibles dans les systèmes d’exploitation Windows : Windows Server 2003, Windows XP, Windows 2000 ou Windows NT 4.0. Les exemples Remclien, Freserve et Freclien sont générés, mais ne s’exécutent pas sur les systèmes d’exploitation Windows Me, Windows 98 ou Windows 95, sauf si le com distribué (DCOM) et le com à thread libre font partie du système d’exploitation. Cette prise en charge est disponible pour les systèmes d’exploitation Windows Me, Windows 98 et Windows 95 dans le module complémentaire DCOM95.
Chaque répertoire d’exemple contient les fichiers sources nécessaires pour générer et exécuter l’exemple. L’exemple de répertoire parent a un fichier Makeall.bat, que vous pouvez exécuter à partir de l’invite de commandes pour créer tous les exemples de code dans la branche ci-dessous. Pour plus d’informations, consultez le fichier Makeall.bat. Si votre environnement est configuré pour générer des applications Win32 C++, vous pouvez simplement exécuter Makeall.bat à partir du répertoire où il réside pour générer tous les exemples de code dans la branche ci-dessous. Makeall garantit l’ordre correct de la build afin que toutes les dépendances d’exemples de code soient satisfaites.
Le répertoire main a également un makefile qui génère tous les exemples de code du didacticiel à l’aide d’options similaires à celles prises en charge par Makeall.bat. Pour plus d’informations, consultez ce makefile. Ce makefile part du principe que la branche d’exemples de code entière est installée dans le cadre du Kit de développement logiciel (SDK) Windows. Actuellement, cet emplacement a un chemin similaire à D:\MSSDK\SAMPLES\COM\TUTSAMP, où D: représente le lecteur d’installation. Si vous avez extrait l’exemple de branche de code du didacticiel (par exemple, le répertoire COM et ses sous-répertoires) à un autre emplacement en dehors du Kit de développement logiciel (SDK) Windows (ou si vous avez obtenu l’exemple de jeu sous la forme d’un téléchargement distinct à partir du site web Microsoft), utilisez Makeall.bat pour compiler tous les exemples dans la branche. En général, Makeall.bat est recommandé. Un fichier Logmall.bat est également fourni. Il fait la même chose que le fichier de commandes Makeall, sauf qu’il journalise toute la sortie de compilation dans le fichier Errorlog.txt dans le répertoire main didacticiel.
Deux fichiers de commandes, Regall.bat et Unregall.bat, sont également fournis dans le répertoire main pour inscrire et annuler l’inscription de tous les serveurs COM dans la série d’exemples de code du didacticiel. Pour inscrire tous les serveurs, exécutez Regall.bat fichier à partir du répertoire main. Pour annuler l’inscription de tous les serveurs, exécutez Unregall.bat de la même manière. Ces fichiers de commandes nécessitent une build antérieure des exemples de code REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE et CONSERVE. Si vous effectuez une génération normale des exemples de code, les makefiles de serveur inscrivent automatiquement les serveurs. Dans ce cas, il n’est pas nécessaire d’exécuter le fichier de commandes Regall.
Exécutez le fichier de commandes Cleanall.bat pour effectuer un nettoyage complet de tous les exemples de didacticiel COM.
Avertissement
Ce fichier de commandes supprime tous les fichiers projet Visual Studio et autres fichiers de travail temporaires créés par Visual C++ dans les exemples. Tous les serveurs COM créés dans les exemples de code du didacticiel sont désinscrits du Registre. Tous les fichiers exécutables exe et .dll sont supprimés. Tous les fichiers de symboles de débogage sont supprimés. Les fichiers générés dans divers environnements de build sont également supprimés.
Exécutez « Makeall Clean » pour effectuer un nettoyage plus rapide, mais plus modeste, de tous les exemples de code. Cette opération de nettoyage ne tente pas d’être aussi complète que celle effectuée par Cleanall.bat. Les fichiers .obj sont supprimés, mais les fichiers binaires de sortie sont conservés. Les serveurs COM ne sont pas désinscrits du Registre.
Cet exemple de série fait partie intégrante du Kit de développement logiciel (SDK) Windows. Par conséquent, le récit du didacticiel suppose un environnement avec le KIT DE développement logiciel (SDK) Windows correctement installé.
Toutefois, les versions de Microsoft Visual C++ version 4.0 et ultérieures peuvent également fournir les fichiers de bibliothèque .h include et .lib requis pour la compilation. Dans ce cas, l’installation du Kit de développement logiciel (SDK) Windows peut ne pas être nécessaire pour compiler les exemples.
Pour plus d’informations et pour obtenir des détails sur les exemples de build, consultez :
Configuration de l’environnement
Extraction des exemples de code
Conventions de style de codage