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 / remclien / remclien.txt < prev    next >
Encoding:
Text File  |  1997-08-05  |  5.0 KB  |  105 lines
  1.  
  2. REMCLIEN -- Distributed COM (DCOM) Remote Client
  3.  
  4.  
  5. SUMMARY
  6. =======
  7.  
  8. The REMCLIEN sample shows how a client can access and control components
  9. in an out-of-process remote server. In this lesson the previously studied
  10. out-of-process server APTSERVE is used, but now it is accessed across
  11. machine boundaries by REMCLIEN. In earlier lessons, APTCLIEN accessed
  12. APTSERVE's components on the same machine by crossing only process and
  13. thread boundaries.
  14.  
  15. No changes to APTSERVE are required for REMCLIEN to work. Distributed COM
  16. (DCOM) supports local/remote transparency between client and server.
  17.  
  18. The REMCLIEN sample presents the car-related components that were studied
  19. in previous lessons. These COM objects use the following interfaces: ICar,
  20. IUtility, and ICruise. REMCLIEN works in conjunction with the separate
  21. APTSERVE.EXE, which provides the COCar, COUtilityCar, and COCruiseCar
  22. COM objects.
  23.  
  24. REMCLIEN.EXE creates its own COUtilityCruiseCar COM object by reusing the
  25. COCruiseCar COM object by containment and augmenting it with a native
  26. implementation of the IUtility interface. Because the COCruiseCar COM
  27. object class is a composite--that is, it reuses an inner COCar object by
  28. containment--REMCLIEN illustrates nested reuse of COM objects. The
  29. composite COUtilityCruiseCar object reuses COCruiseCar, another composite
  30. COM object, by containment. COCruiseCar further reuses the COCar COM
  31. object by containment.
  32.  
  33. The composition of COUtilityCruiseCar is also interesting because
  34. the COUtilityCruiseCar object's containment of the COCruiseCar object
  35. crosses the machine boundary between REMCLIEN and the out-of-process
  36. remote server APTSERVE.EXE. REMCLIEN uses standard marshaling
  37. support for the custom interfaces it uses on the COCruiseCar object. This
  38. marshaling support was separately built as MARSHAL.DLL in the earlier
  39. MARSHAL code sample.
  40.  
  41. For functional descriptions and a tutorial code tour of REMCLIEN, see the
  42. Code Tour section in REMCLIEN.HTM. For details on the external user
  43. operation of REMCLIEN, see both the Usage and Operation sections in
  44. REMCLIEN.HTM. To read REMCLIEN.HTM, run TUTORIAL.EXE in the main tutorial
  45. directory and click the REMCLIEN lesson in the table of lessons. You can
  46. also achieve the same thing by clicking the REMCLIEN.HTM file after
  47. locating the main tutorial directory in the Windows Explorer. See also
  48. APTSERVE.HTM in the main tutorial directory for more details on how
  49. APTSERVE works and exposes its services to REMCLIEN. The makefile for
  50. APTSERVE automatically registers that server in the registry of the host
  51. machine, so you must build APTSERVE on the remote machine before
  52. attempting to run REMCLIEN.
  53.  
  54. Because client and server reside in separate processes on different
  55. machines, both REMCLIEN and APTSERVE rely on marshaling for the ICar,
  56. IUtility, and ICruise interfaces. This support was provided by the
  57. previous MARSHAL code sample, so you must also build the MARSHAL code
  58. sample on both machines prior to building and running REMCLIEN with
  59. APTSERVE.
  60.  
  61. To set up for the proper operation of REMCLIEN on one machine to control
  62. APTSERVE on the other, both machines must be running Windows NT
  63. Workstation 4.0 or above. Earlier versions do not support Distributed COM
  64. (DCOM). The two machine must be connected in a properly configured
  65. network. For details on setting up a network, see your Windows NT product
  66. documentation or the Windows NT Resource Kit. Also see the "Network and
  67. Setup Issues" section at the end of this tutorial text for more details on
  68. machine and network setup for running REMCLIEN.
  69.  
  70. For general details on setting up your system to build and test Win32 code
  71. samples such as those in this COM Tutorial series, see TUTORIAL.HTM. The
  72. supplied MAKEFILE is Microsoft NMAKE-compatible. To create a debug build,
  73. issue the NMAKE command in the Command Prompt window.
  74.  
  75. Usage
  76. -----
  77.  
  78. REMCLIEN is an application that you can execute directly from Windows in
  79. the normal manner or from the Command Prompt window. No command line
  80. parameters are recognized by REMCLIEN. REMCLIEN will not currently run on
  81. the Windows 95 operating system until the necessary Distributed COM is
  82. supported there.
  83.  
  84.  
  85. FILES
  86. =====
  87.  
  88. Files          Description
  89.  
  90. REMCLIEN.TXT   This file.
  91. MAKEFILE       The generic makefile for building the code sample
  92.                application of this tutorial lesson.
  93. REMCLIEN.H     The include file for the REMCLIEN application. Contains
  94.                class declarations, function prototypes, and resource
  95.                identifiers.
  96. REMCLIEN.CPP   The main implementation file for REMCLIEN.EXE. Has WinMain
  97.                and CMainWindow implementation, as well as the main menu
  98.                dispatching.
  99. REMCLIEN.RC    The application resource definition file.
  100. REMCLIEN.ICO   The application icon resource.
  101. UTCRUCAR.H     The class declaration for the COUtilityCruiseCar COM object.
  102. UTCRUCAR.CPP   Implementation file for the COUtilityCruiseCar COM object.
  103.                Also has the definition of the CreateUtilityCruiseCar
  104.                function.
  105.