home *** CD-ROM | disk | FTP | other *** search
/ PC Press 1997 July / Sezamfile97_2.iso / windows / program / activex / axtsamp.exe / TSBRANCH.EXE / COMOBJ / COMOBJ.TXT < prev    next >
Text File  |  1997-01-05  |  3KB  |  75 lines
  1.  
  2. COMOBJ - COM Objects in a DLL
  3.  
  4.  
  5. SUMMARY
  6. =======
  7.  
  8. The COMOBJ DLL offers several car-related COM object classes. Because
  9. COMOBJ.DLL supports no object handlers, class factories, full in-process
  10. servers, or marshshaling, it is not a full-blown COM Server. Rather, it is
  11. a primitive precursor to an COM in-process server.
  12.  
  13. This DLL exposes the following COM objects: COCar, COUtilityCar, and
  14. COCruiseCar. Appropriate create functions are exported from this DLL:
  15. CreateCar, CreateUtilityCar, and CreateCruiseCar.
  16.  
  17. In this tutorial, COMOBJ works with the COMUSER code sample to show how an
  18. EXE client (COMUSER.EXE) calls COM object creation services and manipulates
  19. the COM objects that are created.
  20.  
  21. For functional descriptions and a tutorial code tour of COMOBJ, see the
  22. Code Tour section in COMOBJ.HTM. For details on setting up the
  23. programmatic usage of COMOBJ, see the Usage section in COMOBJ.HTM. To read
  24. COMOBJ.HTM, run TUTORIAL.EXE in the main tutorial directory and click the
  25. COMOBJ lesson in the table of lessons. You can also achieve the same thing
  26. by clicking the COMOBJ.HTM file after locating the main tutorial directory
  27. in the Windows Explorer. See also COMUSER.HTM in the main tutorial
  28. directory for more details on the COMUSER client application and how it
  29. works with COMOBJ.DLL itself. You must build COMOBJ.DLL before building
  30. COMUSER. The makefile for COMOBJ copies the necessary COMOBJ.H,
  31. COMOBJ.LIB, and COMOBJ.DLL files to the appropriate sibling directories
  32. once the files are built. The .H goes to \INC, the .LIB goes to \LIB, and
  33. the .DLL goes to \COMUSER.
  34.  
  35. In general, to set up your system to build and test the code samples in
  36. this ActiveX Tutorial series, see TUTORIAL.HTM for details. The supplied
  37. makefile is Microsoft NMAKE-compatible. To create a debug build, issue the
  38. NMAKE command at the command prompt.
  39.  
  40. Usage
  41. -----
  42.  
  43. COMOBJ is a DLL that you can access from .EXE modules either by performing
  44. an explicit LoadLibrary call or implicitly loading the DLL by linking to its
  45. associated import library (.LIB) file. In either case, you need to include
  46. COMOBJ.H to declare the functions that are defined as exported in the COMOBJ
  47. DLL. In this lesson, a representative COMUSER.EXE application is provided
  48. to illustrate the programmatic use of COMOBJ.DLL. COMUSER is built in the
  49. COMUSER lesson (in sibling directory COMUSER). See below for more details.
  50.  
  51.  
  52. FILES
  53. =====
  54.  
  55. Files       Description
  56.  
  57. COMOBJ.TXT  This file.
  58. MAKEFILE    The generic makefile for building the COMOBJ.DLL code sample.
  59. COMOBJ.H    The include file for declaring as imported or defining as
  60.             exported the service functions in COMOBJ.DLL.
  61. COMOBJ.CPP  The main implementation file for COMOBJ.DLL. Has DllMain
  62.             and the COM Object creation functions.
  63. CAR.H       The include file for the COCar COM object class.
  64. CAR.CPP     The implementation file for the COCar COM object class.
  65. UTILCAR.H   The include file for the COUtilityCar COM object class.
  66. UTILCAR.CPP The implementation file for the COUtilityCar COM object class.
  67. CRUCAR.H    The include file for the COCruiseCar COM object class.
  68. CRUCAR.CPP  The implementation file for the COCruiseCar COM object class.
  69. COMOBJI.H   The include file for the internal class declarations and
  70.             resource identifier definitions for resources stored inside
  71.             the COMOBJ.DLL.
  72. COMOBJ.RC   The DLL resource definition file.
  73. COMOBJ.ICO  The icon resource.
  74.  
  75.