FACTORY.H
上传用户:bangxh
上传日期:2007-01-31
资源大小:42235k
文件大小:5k
源码类别:

Windows编程

开发平台:

Visual C++

  1. /*+==========================================================================
  2.   File:      FACTORY.H
  3.   Summary:   Include file for the class factory COM object: CFPaper. This
  4.              constitutes the STOSERVE server's class factory for the
  5.              DllPaper COM component.
  6.              The multiple interface COM Object Class is achieved via the
  7.              technique of nested classes: the implementation of the
  8.              standard IClassFactory interface is nested inside of the
  9.              class factory COM object class. APPUTIL's CThreaded OwnThis
  10.              mechanism is used to ensure mutually exclusive access to the
  11.              class factory by contending multiple threads.
  12.              For a comprehensive tutorial code tour of this module's
  13.              contents and offerings see the tutorial STOSERVE.HTM
  14.              file. For more specific technical details on the internal
  15.              workings see the comments dispersed throughout the module's
  16.              source code.
  17.   Classes:   CFPaper.
  18.   Functions: .
  19.   Origin:    6-10-96: atrent - Editor-inheritance from FACTORY.H in
  20.                the CONSERVE Tutorial Code Sample.
  21. ----------------------------------------------------------------------------
  22.   This file is part of the Microsoft COM Tutorial Code Samples.
  23.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  24.   This source code is intended only as a supplement to Microsoft
  25.   Development Tools and/or on-line documentation.  See these other
  26.   materials for detailed information regarding Microsoft code samples.
  27.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  28.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  29.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  30.   PARTICULAR PURPOSE.
  31. ==========================================================================+*/
  32. #if !defined(FACTORY_H)
  33. #define FACTORY_H
  34. #ifdef __cplusplus
  35. /*O+O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O
  36.   ObjectClass: CFPaper
  37.   Summary:     Class Factory COM Object Class for DllPaper COM components.
  38.                Used to manufacture COPaper COM objects.  The mulitple
  39.                interfaces on this COM object class are constructed via the
  40.                nested interface classes technique.
  41.   Interfaces:  IUnknown
  42.                  Standard interface providing COM object features.
  43.                IClassFactory
  44.                  Standard interface providing COM Class Factory features.
  45.   Aggregation: Yes, CFPaper COM objects are aggregatable by
  46.                passing a non-NULL pUnkOuter IUnknown pointer into the
  47.                constructor.
  48. O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O-O*/
  49. class CFPaper : public IUnknown, public CThreaded
  50. {
  51.   public:
  52.     // Main Object Constructor & Destructor.
  53.     CFPaper(IUnknown* pUnkOuter, CServer* pServer);
  54.     ~CFPaper(void);
  55.     // IUnknown methods. Main object, non-delegating.
  56.     STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  57.     STDMETHODIMP_(ULONG) AddRef(void);
  58.     STDMETHODIMP_(ULONG) Release(void);
  59.     // We declare nested class interface implementations here.
  60.     // We implement the IClassFactory interface in this class
  61.     // factory COM object class. Derive also from abstract CThreaded
  62.     // to provide the OwnThis/UnownThis thread-safety mechanism.
  63.     class CImpIClassFactory : public IClassFactory, public CThreaded
  64.     {
  65.       public:
  66.         // Interface Implementation Constructor & Destructor.
  67.         CImpIClassFactory(
  68.           CFPaper* pBackObj,
  69.           IUnknown* pUnkOuter,
  70.           CServer* pServer);
  71.         ~CImpIClassFactory(void);
  72.         // IUnknown methods.
  73.         STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  74.         STDMETHODIMP_(ULONG) AddRef(void);
  75.         STDMETHODIMP_(ULONG) Release(void);
  76.         // IClassFactory methods.
  77.         STDMETHODIMP         CreateInstance(IUnknown*, REFIID, PPVOID);
  78.         STDMETHODIMP         LockServer(BOOL);
  79.       private:
  80.         // Data private to this interface implementation of IClassFactory.
  81.         CFPaper*      m_pBackObj;    // Parent Object back pointer.
  82.         IUnknown*     m_pUnkOuter;   // Outer unknown for Delegation.
  83.         CServer*      m_pServer;     // Server's control object.
  84.     };
  85.     // Make the otherwise private and nested IClassFactory interface
  86.     // implementation a friend to COM object instantiations of this
  87.     // CFPaper COM object class.
  88.     friend CImpIClassFactory;
  89.   private:
  90.     // Private data of CFPaper COM objects.
  91.     // Nested IClassFactory implementation instantiation.
  92.     CImpIClassFactory m_ImpIClassFactory;
  93.     // Main Object reference count.
  94.     ULONG             m_cRefs;
  95.     // Outer unknown (aggregation & delegation). Used when this
  96.     // CFPaper object is being aggregated.  Otherwise it is used
  97.     // for delegation if this object is reused via containment.
  98.     IUnknown*         m_pUnkOuter;
  99.     // Pointer to this component server's control object.
  100.     CServer*          m_pServer;
  101. };
  102. typedef CFPaper* PCFPaper;
  103. #endif // __cplusplus
  104. #endif // FACTORY_H