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

Windows编程

开发平台:

Visual C++

  1. /*+==========================================================================
  2.   File:      CAR.H
  3.   Summary:   Include file for the aggregatable COCar COM object class.
  4.              Of particular interest for an COM application, CAR
  5.              showcases a COM Object Class offering a main IUnknown
  6.              interface and the ICar interface (Car-related features).
  7.              This multiple interface COM Object Class is achieved via
  8.              the technique of nested classes.  The implementation of the
  9.              ICar interface is nested inside of the COCar Class.
  10.              For a comprehensive tutorial code tour of this module's
  11.              contents and offerings see the tutorial COMOBJ.HTM
  12.              file.  For more specific technical details on the internal
  13.              workings see the comments dispersed throughout the
  14.              module's source code.
  15.   Classes:   COCar
  16.   Functions:
  17.   Origin:    8-17-95: atrent - Created.
  18. ----------------------------------------------------------------------------
  19.   This file is part of the Microsoft COM Tutorial Code Samples.
  20.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  21.   This source code is intended only as a supplement to Microsoft
  22.   Development Tools and/or on-line documentation.  See these other
  23.   materials for detailed information regarding Microsoft code samples.
  24.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  25.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  26.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  27.   PARTICULAR PURPOSE.
  28. ==========================================================================+*/
  29. #if !defined(CAR_H)
  30. #define CAR_H
  31. #ifdef __cplusplus
  32. /*O+O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O
  33.   ObjectClass: COCar
  34.   Summary:     COM object class for COCar COM objects.  COM objects of
  35.                this class offer ICar interface features (Shift, Clutch,
  36.                Speed, and Steer).  The mulitple interfaces on this COM
  37.                object are constructed via the nested interface classes
  38.                technique.
  39.   Interfaces:  IUnknown
  40.                  Standard interface providing COM object features.
  41.                ICar
  42.                  Basic Car operation features.
  43.   Aggregation: Yes, COCar COM Objects are aggregatable by passing
  44.                a non-NULL pUnkOuter IUnknown pointer into the constructor.
  45. O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O-O*/
  46. class COCar : public IUnknown
  47. {
  48.   public:
  49.     // Main Object Constructor & Destructor.
  50.     COCar(IUnknown* pUnkOuter);
  51.     ~COCar(void);
  52.     // IUnknown methods. Main object, non-delegating.
  53.     STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  54.     STDMETHODIMP_(ULONG) AddRef(void);
  55.     STDMETHODIMP_(ULONG) Release(void);
  56.   private:
  57.     // We declare nested class interface implementations here.
  58.     class CImpICar : public ICar
  59.     {
  60.       public:
  61.         // Interface Implementation Constructor & Destructor.
  62.         CImpICar(COCar* pBackObj, IUnknown* pUnkOuter);
  63.         ~CImpICar(void);
  64.         // IUnknown methods.
  65.         STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  66.         STDMETHODIMP_(ULONG) AddRef(void);
  67.         STDMETHODIMP_(ULONG) Release(void);
  68.         // ICar methods.
  69.         STDMETHODIMP Shift(short nGear);
  70.         STDMETHODIMP Clutch(short nEngaged);
  71.         STDMETHODIMP Speed(short nMph);
  72.         STDMETHODIMP Steer(short nAngle);
  73.       private:
  74.         // Data private to this COCar interface implementation of ICar.
  75.         ULONG        m_cRefI;        // Interface Ref Count (for debugging).
  76.         COCar*       m_pBackObj;     // Parent Object back pointer.
  77.         IUnknown*    m_pUnkOuter;    // Outer unknown for Delegation.
  78.     };
  79.     // Make the otherwise private and nested ICar interface implementation
  80.     // a friend to COM object instantiations of this selfsame COCar
  81.     // COM object class.
  82.     friend CImpICar;
  83.     // Private data of COCar COM objects.
  84.     // Nested ICar implementation instantiation.  This ICar interface
  85.     // is instantiated inside this COCar object as a native interface.
  86.     CImpICar         m_ImpICar;
  87.     // Main Object reference count.
  88.     ULONG            m_cRefs;
  89.     // Outer unknown (aggregation & delegation).
  90.     IUnknown*        m_pUnkOuter;
  91. };
  92. typedef COCar* PCOCar;
  93. #endif // __cplusplus
  94. #endif // CAR_H