CComModule, classe

Article
06/09/2015

As of ATL 7,0, CComModule est déconseillé : consultez Classes de module ATL pour plus de détails.

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.

class CComModule : public _ATL_MODULE

Membres

Méthodes publiques

Nom	Description
CComModule::GetClassObject	Crée un objet de le CLSID spécifié. Pour DLLs uniquement.
CComModule::GetModuleInstance	retourne m_hInst ;
CComModule::GetResourceInstance	retourne m_hInstResource ;
CComModule::GetTypeLibInstance	retourne m_hInstTypeLib ;
CComModule::Init	Initialise les données membres.
CComModule::RegisterClassHelper	Écrit l'inscription standard de la classe d'un objet dans la base de registres.
CComModule::RegisterClassObjects	Stocke l'objet de classe. Pour EXE uniquement.
CComModule::RegisterServer	Met à jour la base de registres pour chaque objet dans la table d'objets.
CComModule::RegisterTypeLib	Enregistre une bibliothèque de types.
CComModule::RevokeClassObjects	Révoque l'objet de classe. Pour EXE uniquement.
CComModule::Term	Récupère les données membres.
CComModule::UnregisterClassHelper	Supprime l'inscription standard de la classe d'un objet de la base de registres.
CComModule::UnregisterServer	Annule l'inscription chaque objet dans la table d'objets.
CComModule::UpdateRegistryClass	Les registres ou annule l'inscription l'inscription standard de la classe d'un objet.
CComModule::UpdateRegistryFromResourceD	Exécute le script contenu dans une ressource spécifiée pour inscrire ou annuler l'inscription d'un objet.
CComModule::UpdateRegistryFromResourceS	Lie statiquement au composant de Registre ATL. Exécute le script contenu dans une ressource spécifiée pour inscrire ou annuler l'inscription d'un objet.

Données membres publiques

Nom	Description
CComModule::m_csObjMap	Ensures a synchroniser l'accès aux informations de mappage d'objets.
CComModule::m_csTypeInfoHolder	Ensures a synchroniser l'accès aux informations de bibliothèque de types.
CComModule::m_csWindowCreate	Ensures a synchroniser l'accès aux informations de classe de fenêtre et aux données statiques utilisées lors de la création de fenêtre.
CComModule::m_hInst	Contient le handle vers l'instance du module.
CComModule::m_hInstResource	Par défaut, contient le handle vers l'instance du module.
CComModule::m_hInstTypeLib	Par défaut, contient le handle vers l'instance du module.
CComModule::m_pObjMap	Pointe vers la table d'objets mise à jour par l'instance du module.

Notes

Cette classe est déconseillée, et les assistants de génération de code ATL utilisent maintenant CAtlAutoThreadModule et les classes dérivées par CAtlModule .Consultez Classes de module ATL pour plus d'informations.Les informations qui suivent utilisent avec les applications créées avec des versions plus anciennes ATL.CComModule est toujours partie ATL pour en arrière la fonction.

CComModule implémente un module de serveur COM, ce qui permet à un client d'accéder aux composants du module. CComModule prend en charge les modules de DLL (in-process) et EXE (local).

Une instance d' CComModule utilise une table d'objets pour mettre à jour un ensemble de définitions d'objet de classe. Cette table d'objets est implémentée comme tableau de structures d' _ATL_OBJMAP_ENTRY , et contient les informations pour :

Écriture et supprimant des descriptions d'objet dans la base de registres.
Instancier des objets via une fabrique de classe.
Établir une communication entre un client et l'objet racine dans le composant.
Effectuer la gestion de la durée de vie des objets de classe.

Lorsque vous exécutez l'ATL COM AppWizard, l'assistant génère automatiquement _Module, une instance globale d' CComModule ou une classe dérivée d'elle. Pour plus d'informations sur l'Assistant Projet ATL, consultez l'article Création d'un projet ATL.

En plus de CComModule, ATL fournit CComAutoThreadModule, qui implémente un module de modèle cloisonné pour EXE et services windows. Dérivez votre package d' CComAutoThreadModule lorsque vous souhaitez créer des objets de plusieurs apartments.