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

Windows编程

开发平台:

Visual C++

  1. /*+==========================================================================
  2.   File:      SAMPLE.H
  3.   Summary:   Declares a COCarSample utility COM object used to implement
  4.              the server as a code sample (mainly with an Init method
  5.              to enable setting up Trace logging of activity in the
  6.              server to the logging facility in the Client).
  7.              For a comprehensive tutorial code tour of this module's
  8.              contents and offerings see the tutorial DLLSERVE.HTM file.
  9.              For more specific technical details on the internal workings
  10.              see the comments dispersed throughout the module's source code.
  11.   Classes:   COCarSample.
  12.   Functions: none
  13.   Origin:    9-11-95: atrent - Editor-inheritance from CAR.H in
  14.                the COMOBJ Tutorial Code Sample.
  15. ----------------------------------------------------------------------------
  16.   This file is part of the Microsoft COM Tutorial Code Samples.
  17.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  18.   This source code is intended only as a supplement to Microsoft
  19.   Development Tools and/or on-line documentation.  See these other
  20.   materials for detailed information regarding Microsoft code samples.
  21.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  22.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  23.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  24.   PARTICULAR PURPOSE.
  25. ==========================================================================+*/
  26. #if !defined(SAMPLE_H)
  27. #define SAMPLE_H
  28. #ifdef __cplusplus
  29. /*O+O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O
  30.   ObjectClass: COCarSample
  31.   Summary:     Utility CarSample COM Object Class for the DLLSERVE server
  32.                as a code sample.
  33.   Interfaces:  IUnknown
  34.                  Standard interface providing COM object features.
  35.                ISample
  36.                  Sample-specific Utility services for server as a whole.
  37.   Aggregation: Yes, COCarSample COM objects are aggregatable by
  38.                passing a non-NULL pUnkOuter IUnknown pointer into the
  39.                constructor.
  40. O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O-O*/
  41. class COCarSample : public IUnknown
  42. {
  43.   public:
  44.     // Main Object Constructor & Destructor.
  45.     COCarSample(IUnknown* pUnkOuter, CServer* pServer);
  46.     ~COCarSample(void);
  47.     // IUnknown methods. Main object, non-delegating.
  48.     STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  49.     STDMETHODIMP_(ULONG) AddRef(void);
  50.     STDMETHODIMP_(ULONG) Release(void);
  51.   private:
  52.     // We declare nested class interface implementations here.
  53.     // We implement the ISample interface in this COCarSample
  54.     // COM object class.
  55.     class CImpISample : public ISample
  56.     {
  57.       public:
  58.         // Interface Implementation Constructor & Destructor.
  59.         CImpISample(
  60.           COCarSample* pBackObj,
  61.           IUnknown* pUnkOuter,
  62.           CServer* pServer);
  63.         ~CImpISample(void);
  64.         // IUnknown methods.
  65.         STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  66.         STDMETHODIMP_(ULONG) AddRef(void);
  67.         STDMETHODIMP_(ULONG) Release(void);
  68.         // ISample methods.
  69.         STDMETHODIMP         Init(HWND, PVOID);
  70.         STDMETHODIMP         AboutBox(HWND);
  71.       private:
  72.         // Data private to this interface implementation of ISample.
  73.         ULONG         m_cRefI;        // Interface Ref Count (for debugging).
  74.         COCarSample*  m_pBackObj;     // Parent Object back pointer.
  75.         IUnknown*     m_pUnkOuter;    // Outer unknown for Delegation.
  76.         CServer*      m_pServer;      // Server Control object.
  77.     };
  78.     // Make the otherwise private and nested ISample interface
  79.     // implementation a friend to COM object instantiations of this
  80.     // selfsame COCarSample COM object class.
  81.     friend CImpISample;
  82.     // Private data of COCarSample COM objects.
  83.     // Nested ISample implementation instantiation.
  84.     CImpISample      m_ImpISample;
  85.     // Main Object reference count.
  86.     ULONG            m_cRefs;
  87.     // Outer unknown (aggregation & delegation). Used when this
  88.     // COCarSample object is being aggregated.  Otherwise it is used
  89.     // for delegation if this object is reused via containment.
  90.     IUnknown*        m_pUnkOuter;
  91.     // Pointer to this component server's control object.
  92.     CServer*         m_pServer;
  93. };
  94. typedef COCarSample* PCOCarSample;
  95. #endif // __cplusplus
  96. #endif // SAMPLE_H