home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / com / tutsamp / aptserve / server.h < prev    next >
Encoding:
C/C++ Source or Header  |  1997-08-30  |  4.1 KB  |  131 lines
  1. /*+==========================================================================
  2.   File:      SERVER.H
  3.  
  4.   Summary:   Internal include file for the APTSERVE.EXE local server code
  5.              sample.  Contains class declarations, resource IDs and string
  6.              macros for internal use in constructing this EXE as a local
  7.              COM component server using Apartment model multi-threading.
  8.              Declares the CServer server control object class.
  9.  
  10.              For a comprehensive tutorial code tour of this module's
  11.              contents and offerings see the tutorial APTSERVE.HTM file.
  12.              For more specific technical details on the internal workings
  13.              see the comments dispersed throughout the module's source code.
  14.  
  15.   Classes:   CServer.
  16.  
  17.   Functions: none
  18.  
  19.   Origin:    3-11-97: atrent - Editor-inheritance from SERVER.H in
  20.                the LOCSERVE Tutorial Code Sample. [Revised]
  21.  
  22. ----------------------------------------------------------------------------
  23.   This file is part of the Microsoft COM Tutorial Code Samples.
  24.  
  25.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  26.  
  27.   This source code is intended only as a supplement to Microsoft
  28.   Development Tools and/or on-line documentation.  See these other
  29.   materials for detailed information regarding Microsoft code samples.
  30.  
  31.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  32.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  33.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  34.   PARTICULAR PURPOSE.
  35. ==========================================================================+*/
  36.  
  37.  
  38. #if !defined(SERVER_H)
  39. #define SERVER_H
  40.  
  41. #ifdef __cplusplus
  42.  
  43. // Period to wait for all apartment threads to exit/terminate (8 seconds).
  44. #define LONG_WAIT 8000
  45.  
  46. // Appartment Thread Initialization data.
  47. enum { NUM_APARTMENTS = 3 };
  48. enum { APTCAR = 0, APTUTILITYCAR = 1, APTCRUISECAR = 2 };
  49. struct APT_INIT_DATA
  50. {
  51.   REFCLSID rclsid;
  52.   IUnknown* pcf;
  53.  
  54.   // Member initializer MUST be used here because VC++ 4.0+ is strict
  55.   // about const and reference (&) types like REFCLSID that need to
  56.   // be initialized in this app.  For example, VC++ 4.x will not permit
  57.   // a simple assignment of rclsid in the constructor.
  58.   APT_INIT_DATA(REFCLSID rclsidi) : rclsid(rclsidi)
  59.   {
  60.     pcf = NULL;
  61.   };
  62.  
  63.   ~APT_INIT_DATA() {};
  64. };
  65.  
  66.  
  67. /*C+C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C
  68.   Class:    CServer
  69.  
  70.   Summary:  Class to encapsulate control of this COM server (eg, handle
  71.             Lock and Object counting, encapsulate otherwise global data).
  72.             Govern server and Apartment lifetimes.
  73.  
  74.   Methods:  none
  75. C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C-C*/
  76. class CServer : public CThreaded
  77. {
  78.   public:
  79.     CServer(void);
  80.     ~CServer(void);
  81.  
  82.     void Lock(void);
  83.     void Unlock(void);
  84.     void ObjectsUp(void);
  85.     void ObjectsDown(void);
  86.     BOOL OpenFactories(void);
  87.     BOOL CloseFactories(void);
  88.  
  89.     // CThreaded method overrides.
  90.     BOOL OwnThis(void);
  91.     void UnOwnThis(void);
  92.  
  93.     // A place to store the server's instance handle.
  94.     HINSTANCE m_hInstServer;
  95.  
  96.     // A place to store the server's main window.
  97.     HWND      m_hWndServer;
  98.  
  99.     // Global Server living Object count.
  100.     LONG      m_cObjects;
  101.  
  102.     // Global Server Client Lock count.
  103.     LONG      m_cLocks;
  104.  
  105.     // Some member variables to store pointers to Class Factories.
  106.     IUnknown* m_pCFCar;
  107.     IUnknown* m_pCFUtilityCar;
  108.     IUnknown* m_pCFCruiseCar;
  109.  
  110.     // Pointers to Apartment init data structures.
  111.     APT_INIT_DATA* m_paiAptCar;
  112.     APT_INIT_DATA* m_paiAptUtilityCar;
  113.     APT_INIT_DATA* m_paiAptCruiseCar;
  114.  
  115.     // Some member variables to store apartment thread ids.
  116.     DWORD     m_dwAptCar;
  117.     DWORD     m_dwAptUtilityCar;
  118.     DWORD     m_dwAptCruiseCar;
  119.  
  120.     // An array of handles to the apartment threads.
  121.     HANDLE    m_hApts[NUM_APARTMENTS];
  122. };
  123.  
  124. #endif // __cplusplus
  125.  
  126. // Allow other internal APTSERVE modules to get at the globals.
  127. extern CServer*  g_pServer;
  128. extern CSendLog* g_pMsgLog;
  129.  
  130. #endif // SERVER_H
  131.