Macros de mappage d’objets

Ces macros définissent des mappages d’objets et des entrées.

Nom	Description
DECLARE_OBJECT_DESCRIPTION	Vous permet de spécifier la description de texte d’un objet de classe, qui sera entrée dans le mappage d’objets.
OBJECT_ENTRY_AUTO	Entre un objet ATL dans le mappage d’objets, met à jour le Registre et crée une instance de l’objet.
OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO	Vous pouvez spécifier que l'objet doit être enregistré et initialisé, mais il ne doit pas pouvoir être créé en externe via CoCreateInstance.

Spécifications

En-tête : atlcom.h

DECLARE_OBJECT_DESCRIPTION

Vous permet de spécifier une description de texte pour votre objet de classe.

DECLARE_OBJECT_DESCRIPTION( x )

Paramètres

x
[in] Description de l’objet de classe.

Notes

ATL entre cette description dans le mappage d’objets via la macro OBJECT_ENTRY_AUTO .

DECLARE_OBJECT_DESCRIPTION implémente une GetObjectDescription fonction, que vous pouvez utiliser pour remplacer la méthode CComCoClass ::GetObjectDescription .

La GetObjectDescription fonction est appelée par IComponentRegistrar::GetComponents. IComponentRegistrar est une interface Automation qui vous permet d’inscrire et de désinscrire des composants individuels dans une DLL. Lorsque vous créez un objet De bureau d’enregistrement de composants avec l’Assistant Projet ATL, l’Assistant implémente automatiquement l’interface IComponentRegistrar . IComponentRegistrar est généralement utilisé par Microsoft Transaction Server.

Pour plus d’informations sur l’Assistant Projet ATL, consultez l’article Création d’un projet ATL.

Exemple

class ATL_NO_VTABLE CMyDescribedClass :
   public CComObjectRoot,
   public CComCoClass<CMyDescribedClass, &CLSID_MyDescribedClass>
{
public:
   CMyDescribedClass()
   {
   }

   // Override CComCoClass::GetObjectDescription
   DECLARE_OBJECT_DESCRIPTION("My Described Object 1.0")
};

OBJECT_ENTRY_AUTO

Entre un objet ATL dans le mappage d’objets, met à jour le Registre et crée une instance de l’objet.

OBJECT_ENTRY_AUTO( clsid, class )

Paramètres

Clsid
[in] CLSID d’une classe COM implémentée par la classe C++ nommée.

class
[in] Nom de la classe C++ implémentant la classe COM représentée par clsid.

Notes

Les macros d'entrées d'objet sont placées au niveau de la portée globale dans le projet pour assurer la prise en charge de l'inscription, de l'initialisation et de la création d'une classe.

OBJECT_ENTRY_AUTO entre les pointeurs de fonction de la classe créateur et les fonctions de classe de créateur de fabrique de classes CreateInstance pour cet objet dans la carte d’objets ATL générée automatiquement. Quand CAtlComModule ::RegisterServer est appelé, il met à jour le registre système pour chaque objet dans le mappage d’objets.

Le tableau ci-dessous décrit comment les informations ajoutées au mappage d’objets sont obtenues à partir de la classe donnée en tant que deuxième paramètre à cette macro.

Informations pour	Obtenu à partir de
Inscription COM	Macros de Registre
Création d’une fabrique de classes	Macros de fabrique de classes
Création d’instance	Macros d’agrégation
Inscription de catégorie de composant	Macros de catégorie
Initialisation au niveau de la classe et propre up	ObjectMain

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO

Vous pouvez spécifier que l'objet doit être enregistré et initialisé, mais il ne doit pas pouvoir être créé en externe via CoCreateInstance.

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO( clsid, class )

Paramètres

Clsid
[in] CLSID d’une classe COM implémentée par la classe C++ nommée.

class
[in] Nom de la classe C++ implémentant la classe COM représentée par clsid.

Notes

Les macros d'entrées d'objet sont placées au niveau de la portée globale dans le projet pour assurer la prise en charge de l'inscription, de l'initialisation et de la création d'une classe.

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO vous permet de spécifier qu’un objet doit être inscrit et initialisé (voir OBJECT_ENTRY_AUTO pour plus d’informations), mais il ne doit pas être créatable via CoCreateInstance.

Voir aussi

Macros