Comment faire pour regrouper un objet COM avec ATL

Traductions disponibles Traductions disponibles
Numéro d'article: 173823 - Voir les produits auxquels s'applique cet article
Remarque Microsoft Visual C++ .NET (2002) prend en charge le modèle de code managé qui est fourni par Microsoft .NET Framework et le modèle de code Microsoft Windows natif non managé. Les informations contenues dans cet article s'appliquent uniquement au code de Visual C++ non managé.
Agrandir tout | Réduire tout

Sommaire

Résumé

Les étapes suivantes montrent comment calculer une COM objet dans un projet ATL :
  1. Ajouter un pointeur IUnknown à votre objet de classe et initialisez-le avec la valeur NULL dans le constructeur.
  2. Ajouter la macro DECLARE_PROTECT_FINAL_CONSTRUCT afin d'empêcher que votre objet en cours de suppression si (pendant FinalConstruct) l'objet regroupé en agrégats interne incrémente le décompte de références puis le décrémente le décompte à 0.

    Remarque : Si vous utilisez Visual C++ .NET l'Assistant ajoute pour vous.
  3. Utilisez le pointeur IUnknown que vous avez défini comme le deuxième paramètre pour les macros COM_INTERFACE_ENTRY_AGGREGATE. Le premier paramètre est l'IID de l'interface de l'objet interne que vous souhaitez exposer.
  4. Substituez FinalConstruct() pour créer l'agrégat.
  5. Substituer FinalRelease() pour libérer de l'interface IUnknown pointeur.

Plus d'informations

Si vous utilisez et libérez une interface à partir de l'agrégat pendant FinalConstruct, vous devez ajouter la macro DECLARE_PROTECT_FINAL_CONSTRUCT à la définition de votre objet classe.

Voici un exemple avec les quatre étapes effectuées dans la définition de classe. Il s'agit d'un objet simple, COutObj, qui regroupe un autre objet simple, CInnObj.

Exemple de code

   class ATL_NO_VTABLE COutObj :
         public CComObjectRootEx<CComSingleThreadModel>,
         public CComCoClass<COutObj, &CLSID_OutObj>,
         public IDispatchImpl<IOutObj, &IID_IOutObj, &LIBID_OUTEROBJLib>
   {
   public:
      COutObj() : m_pInnerUnk(NULL) // Step 1
      {
      }
      DECLARE_GET_CONTROLLING_UNKNOWN()
      DECLARE_REGISTRY_RESOURCEID(IDR_OUTOBJ)
      DECLARE_PROTECT_FINAL_CONSTRUCT() // Step 2

      BEGIN_COM_MAP(COutObj)
         COM_INTERFACE_ENTRY(IOutObj)
         COM_INTERFACE_ENTRY(IDispatch)
         COM_INTERFACE_ENTRY_AGGREGATE(IID_IInnObj, m_pInnerUnk) // Step 3
      END_COM_MAP()

      // Start of step 4
      HRESULT FinalConstruct()
      {
         HRESULT hr;
         CLSID   clsidInner;

         hr = CLSIDFromProgID(L"InnObj.InnObj.1", &clsidInner);
         if (hr == S_OK)
            hr = CoCreateInstance(clsidInner, GetControllingUnknown(),
                                  CLSCTX_INPROC_SERVER, IID_IUnknown,
                                  (void**)&m_pInnerUnk);
         return hr;
      } // End of step 4

      void FinalRelease(){m_pInnerUnk->Release();} // Step 5

      // IOutObj
   public:
      STDMETHOD(Test)();
   private:
      LPUNKNOWN m_pInnerUnk; // Step 1
   };
				
Si l'objet interne est dans le même serveur ATL, puis que vous pouvez utiliser le code suivant pour créer l'objet interne sans CoCreateInstance :
   HRESULT FinalConstruct()
      {
         return  CInnObj::_CreatorClass::CreateInstance(
             GetControllingUnknown(), IID_IUnknown,
             (void**)&m_pInnerUnk);

      }
				

Références

Documentation Visual C++ en ligne : Visual C++ documentation ; langage C/C++ et C++ Library ; Active Template Library ; articles ; Introduction à COM et ATL ; Introduction à COM; agrégation

Documentation Visual C++ en ligne : Visual C++ documentation ; langage C/C++ et C++ Library ; Active Template Library Articles ; Fundamentals of objets ATL COM; création d'un agrégat

Propriétés

Numéro d'article: 173823 - Dernière mise à jour: mardi 29 juin 2004 - Version: 3.1
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft ActiveX Template Library 3.0 sur le système suivant
    • Microsoft Visual C++ 5.0 Édition Entreprise
    • Microsoft Visual C++ 6.0 Édition Entreprise
    • Microsoft Visual C++ 5.0 Édition Professionnelle
    • Microsoft Visual C++ 6.0 Édition Professionnelle
    • Microsoft Visual C++, 32-bit Learning Edition 6.0
    • Microsoft Visual C++ .NET 2002 Initiation
    • Microsoft Visual C++ .NET 2003 Initiation
  • Microsoft ActiveX Template Library 2.1 sur le système suivant
    • Microsoft Visual C++ 5.0 Édition Entreprise
    • Microsoft Visual C++ 6.0 Édition Entreprise
    • Microsoft Visual C++ 5.0 Édition Professionnelle
    • Microsoft Visual C++ 6.0 Édition Professionnelle
    • Microsoft Visual C++, 32-bit Learning Edition 6.0
    • Microsoft Visual C++ .NET 2002 Initiation
    • Microsoft Visual C++ .NET 2003 Initiation
Mots-clés : 
kbmt kbarchitecture kbhowto KB173823 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 173823
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com