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 / aptclien / aptclien.txt < prev    next >
Text File  |  1997-08-05  |  4KB  |  86 lines
  1.  
  2. APTCLIEN - Client of an apartment model out-of-process local server
  3.  
  4.  
  5. SUMMARY
  6. =======
  7.  
  8. The APTCLIEN sample shows a client of several single-threaded apartments
  9. in the APTSERVE server. APTCLIEN's main purpose is to exercise and reveal
  10. for study the multiple apartments in the APTSERVE local out-of-process
  11. server. The following REMCLIEN sample, run in conjunction with APTCLIEN,
  12. shows the effects of multiple clients on the APTSERVE multithreaded
  13. server, with one client controlling from a remote machine.
  14.  
  15. The COM objects that APTCLIEN manipulates are the car-related ones from
  16. previous samples in this tutorial series, with the following interfaces:
  17. ICar, IUtility, and ICruise. APTCLIEN works in conjunction with the
  18. separate APTSERVE.EXE, which provides the COCar, COUtilityCar, and
  19. COCruiseCar COM objects.
  20.  
  21. APTCLIEN.EXE creates its own COUtilityCruiseCar COM object by reusing the
  22. COCruiseCar COM object by containment and augmenting it with a native
  23. implementation of the IUtility interface. Like LOCCLIEN, APTCLIEN's
  24. COUtilityCruiseCar composite object reuses COCruiseCar by containment.
  25. However, because COCruiseCar and COCar are in different apartments,
  26. COCruiseCar reuses COCar by containment rather than the aggregation shown
  27. in previous lessons.
  28.  
  29. The composition of COUtilityCruiseCar is also interesting because the
  30. COUtilityCruiseCar object's containment of the COCruiseCar object crosses
  31. the process boundary between APTCLIEN and the out-of-process local server
  32. APTSERVE.EXE. In addition, COCruiseCar's containment of COCar crosses
  33. thread boundaries within APTSERVE. APTCLIEN uses standard marshaling
  34. support for the custom interfaces it uses on the COCruiseCar and COCar
  35. objects. This marshaling support is provided by the previous MARSHAL
  36. code sample, so you must build the MARSHAL code sample prior to building
  37. and running APTCLIEN and APTSERVE.
  38.  
  39. For functional descriptions and a tutorial code tour of APTCLIEN, see the
  40. Code Tour section in APTCLIEN.HTM. For details on the external user
  41. operation of APTCLIEN, see both the Usage and Operation sections in
  42. APTCLIEN.HTM. To read APTCLIEN.HTM, run TUTORIAL.EXE in the main tutorial
  43. directory and click the APTCLIEN lesson in the table of lessons. You can
  44. also achieve the same thing by clicking the APTCLIEN.HTM file after
  45. locating the main tutorial directory in the Windows Explorer. See also
  46. APTSERVE.HTM in the main directory for more details on how APTSERVE works
  47. and exposes its services to APTCLIEN. You must build APTSERVE.EXE before
  48. building APTCLIEN. The makefile for APTSERVE automatically registers that
  49. server in the registry, so you must build APTSERVE before attempting to
  50. run APTCLIEN.
  51.  
  52. For details on setting up your system to build and test the code samples
  53. in this COM Tutorial series, see TUTORIAL.HTM. The supplied MAKEFILE is
  54. Microsoft NMAKE-compatible. To create a debug build, issue the NMAKE
  55. command in the Command Prompt window.
  56.  
  57. Usage
  58. -----
  59.  
  60. APTCLIEN is an application that you can execute directly from Windows in
  61. the normal manner or from the Command Prompt window. No command line
  62. parameters are recognized by APTCLIEN.
  63.  
  64.  
  65. FILES
  66. =====
  67.  
  68. Files          Description
  69.  
  70. APTCLIEN.TXT   This file.
  71. MAKEFILE       The generic makefile for building the code sample
  72.                application of this tutorial lesson.
  73. APTCLIEN.H     The include file for the APTCLIEN application. Contains
  74.                class declarations, function prototypes, and resource
  75.                identifiers.
  76. APTCLIEN.CPP   The main implementation file for APTCLIEN.EXE. Has WinMain
  77.                and CMainWindow implementation, as well as the main menu
  78.                dispatching.
  79. APTCLIEN.RC    The application resource definition file.
  80. APTCLIEN.ICO   The application icon resource.
  81. UTCRUCAR.H     The class declaration for the COUtilityCruiseCar COM object.
  82. UTCRUCAR.CPP   Implementation file for the COUtilityCruiseCar COM object.
  83.                Also has the definition of the CreateUtilityCruiseCar
  84.                function.
  85.  
  86.