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

Windows编程

开发平台:

Visual C++

  1. /*+==========================================================================
  2.   File:      SERVER.CPP
  3.   Summary:   Implementation file for the CServer server control C++
  4.              object.  This object encapsulates the server's internal
  5.              control of global server object and lock counts. The
  6.              CThreaded OwnThis mechanism is used to ensure mutually
  7.              exclusive access to this CServer object by multiple threads.
  8.              For a comprehensive tutorial code tour of this module's
  9.              contents and offerings see the tutorial STOSERVE.HTM
  10.              file. For more specific technical details on the internal
  11.              workings see the comments dispersed throughout the module's
  12.              source code.
  13.   Classes:   CServer.
  14.   Functions: .
  15.   Origin:    6-10-96: atrent - Editor-inheritance from SERVER.CPP in
  16.                the CONSERVE Tutorial Code Sample.
  17. ----------------------------------------------------------------------------
  18.   This file is part of the Microsoft COM Tutorial Code Samples.
  19.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  20.   This source code is intended only as a supplement to Microsoft
  21.   Development Tools and/or on-line documentation.  See these other
  22.   materials for detailed information regarding Microsoft code samples.
  23.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  24.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  25.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  26.   PARTICULAR PURPOSE.
  27. ==========================================================================+*/
  28. /*---------------------------------------------------------------------------
  29.   We include WINDOWS.H for all Win32 applications.
  30.   We include OLE2.H because we will be calling the COM/OLE Libraries.
  31.   We include APPUTIL.H because we will be building this DLL using
  32.     the convenient Virtual Window and Dialog classes and other
  33.     utility functions in the APPUTIL Library (ie, APPUTIL.LIB).
  34.   We include SERVER.H for the class declarations for the C++ CServer
  35.     server control object.
  36. ---------------------------------------------------------------------------*/
  37. #include <windows.h>
  38. #include <ole2.h>
  39. #include <apputil.h>
  40. #include "server.h"
  41. /*---------------------------------------------------------------------------
  42.   Implementation the internal CServer C++ object.  Used to encapsulate
  43.   some server data and the methods for Lock and Object count incrementing
  44.   and decrementing.
  45. ---------------------------------------------------------------------------*/
  46. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  47.   Method:   CServer::CServer
  48.   Summary:  CServer Constructor.
  49.   Args:     void
  50.   Modifies: .
  51.   Returns:  void
  52. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  53. CServer::CServer(void)
  54. {
  55.   // Zero the Object and Lock counts for this attached process.
  56.   m_cObjects = 0;
  57.   m_cLocks = 0;
  58.   return;
  59. }
  60. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  61.   Method:   CServer::~CServer
  62.   Summary:  CServer Destructor.
  63.   Args:     void
  64.   Modifies: .
  65.   Returns:  void
  66. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  67. CServer::~CServer(void)
  68. {
  69.   return;
  70. }
  71. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  72.   Method:   CServer::Lock
  73.   Summary:  Increment the Server's Lock count.
  74.   Args:     void
  75.   Modifies: .
  76.   Returns:  void
  77. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  78. void CServer::Lock(void)
  79. {
  80.   LONG cLocks;
  81.   if (OwnThis())
  82.   {
  83.     cLocks = ++m_cLocks;
  84.     UnOwnThis();
  85.   }
  86.   return;
  87. }
  88. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  89.   Method:   CServer::Unlock
  90.   Summary:  Decrement the Server's Lock count.
  91.   Args:     void
  92.   Modifies: .
  93.   Returns:  void
  94. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  95. void CServer::Unlock(void)
  96. {
  97.   LONG cLocks;
  98.   if (OwnThis())
  99.   {
  100.     cLocks = --m_cLocks;
  101.     UnOwnThis();
  102.   }
  103.   return;
  104. }
  105. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  106.   Method:   CServer::ObjectsUp
  107.   Summary:  Increment the Server's living Object count.
  108.   Args:     void
  109.   Modifies: .
  110.   Returns:  void
  111. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  112. void CServer::ObjectsUp(void)
  113. {
  114.   LONG cObjects;
  115.   if (OwnThis())
  116.   {
  117.     cObjects = ++m_cObjects;
  118.     UnOwnThis();
  119.   }
  120.   return;
  121. }
  122. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  123.   Method:   CServer::ObjectsDown
  124.   Summary:  Decrement the Server's living object count.
  125.   Args:     void
  126.   Modifies: .
  127.   Returns:  void
  128. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  129. void CServer::ObjectsDown(void)
  130. {
  131.   LONG cObjects;
  132.   if (OwnThis())
  133.   {
  134.     cObjects = --m_cObjects;
  135.     UnOwnThis();
  136.   }
  137.   return;
  138. }
  139. /*M+M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M+++M
  140.   Method:   CServer::CanUnloadNow
  141.   Summary:  Check if we can unload the server (ie, if there are no longer
  142.             any living COM objects and no locks.
  143.   Args:     void
  144.   Modifies: .
  145.   Returns:  HRESULT
  146.               S_OK if this server can be unloaded.
  147.               S_FALSE if this server can not be unloaded.
  148. M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M---M-M*/
  149. HRESULT CServer::CanUnloadNow(void)
  150. {
  151.   HRESULT hr = S_FALSE;
  152.   LONG cObjects, cLocks;
  153.   if (OwnThis())
  154.   {
  155.     cObjects = m_cObjects;
  156.     cLocks = m_cLocks;
  157.     hr = (0L==cObjects && 0L==cLocks) ? S_OK : S_FALSE;
  158.     UnOwnThis();
  159.   }
  160.   return hr;
  161. }