home *** CD-ROM | disk | FTP | other *** search
/ PC Press 1997 July / Sezamfile97_2.iso / windows / program / activex / axtsamp.exe / TSBRANCH.EXE / TUTORIAL.TXT < prev    next >
Text File  |  1997-01-10  |  12KB  |  211 lines
  1. /*+==========================================================================
  2.   File:      TUTORIAL.TXT
  3.  
  4.   Summary:   This directory and those in the branch below contain the
  5.              ActiveX Tutorial Samples. These code samples include an
  6.              integrated tutorial narrative that covers the foundations of
  7.              ActiveX(tm) technology. All source for these samples is in
  8.              C++. MFC is not used. The series is for programmers using
  9.              their proficiency in C++ Win32 programming to code ActiveX
  10.              web applications.
  11.  
  12.              You can start the tutorial by executing TUTORIAL.EXE in this
  13.              directory (ie, the main directory of the installed ActiveX
  14.              Tutorial Samples). Within the tutorial you can jump to web
  15.              pages containing the individual lessons associated with each
  16.              sample. You can also jump to view pages covering how to set
  17.              up your computer environment to build and run the code
  18.              samples,
  19.  
  20.   Origin:    1-6-97: atrent - Revised for ActiveX Tutorial Sample series.
  21.  
  22. ----------------------------------------------------------------------------
  23.   This file is part of the Microsoft ActiveX 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 online 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. ActiveX Tutorial Samples
  39. ========================
  40.  
  41. These ActiveX Tutorial Samples cover the foundations of ActiveX
  42. technology. COM (Component Object Model) technology is the primary
  43. foundation for ActiveX(tm) technology. For example, all ActiveX controls
  44. are COM Component Objects. These tutorial samples concentrate on COM
  45. technology early in the sequence and progress to cover ActiveX components
  46. in the context of web applications.
  47.  
  48. This tutorial sample series is directed to serve foundation-level ActiveX
  49. programmers who are developing web applications using their proficiency in
  50. C++ Win32 programming. If you are developing internet web applications
  51. with ActiveX controls and an integrated development environment like
  52. Microsoft Developer Studio, then you have the benefit of tools and
  53. abstractions that hide most of the technical detail covered in this
  54. series. The series exposes much of the infastructure that is now being
  55. increasingly hidden by MFC (Microsoft Foundation Classes) and ATL (ActiveX
  56. Template Library). This series can help when you need to drop below the
  57. convenient abstractions in MFC or ATL to perform ActiveX/COM-compliant
  58. modifications. Of course, it can also help if you are working directly at
  59. this foundation level of ActiveX programming to develop the highest
  60. performance professional web applications.
  61.  
  62. These source code samples are the same as those currently found as branch
  63. \MSSDK\SAMPLES\OLE\COM of the installed Microsoft Win32 Platform SDK. All
  64. source for these code samples is in C++. Neither MFC nor ATL is used.
  65.  
  66. Each code sample has an associated description of the sample's external
  67. operation and a narrative code tour of the internal construction (based on
  68. the specific goal of the tutorial lesson). This tutorial narrative resides
  69. in a <lesson>.HTM web page file--where <lesson> is the name of the
  70. lesson/code sample. There is one of these narrative HTML files for each
  71. tutorial code sample. All of these HTML files are located in the main
  72. directory of the tutorial samples branch. The complete tutorial is thus
  73. made up of many HTML files located in the parent directory of all the
  74. sample directories. This single parent directory is the main tutorial
  75. directory. Additional details on the internal mechanisms of each sample
  76. can be found in code comments in each source file located in the sample's
  77. directory.
  78.  
  79. The tutorial HTML files for the tutorial samples are linked together into
  80. a web that can be viewed with a web browser. You can start browsing this
  81. tutorial by executing the TUTORIAL.EXE command in the main directory. You
  82. must have a web browser compatible with Microsoft Internet Explorer
  83. installed for TUTORIAL.EXE to work.
  84.  
  85. The ActiveX tutorial samples reside in the following directory tree,
  86. organized in a graduated sequence of tutorial lessons. The numbered order
  87. of lessons is the sequence we recommend that you follow in the tutorial.
  88. Each lesson illustrates a major feature of COM and ActiveX technology.
  89. Most lessons build on the ones that came earlier in the sequence.
  90.  
  91.   COM        - This file, TUTORIAL.EXE, MAKEALL.BAT, etc.
  92.     INC      - Common include directory used by the code samples
  93.     LIB      - Common library directory used by the code samples
  94.     APPUTIL  - Lesson  0: Win32 Basics: Application Utility Library
  95.     READTUT  - Lesson  1: Win32 Basics: Tutorial Reader and Linking to APPUTIL
  96.     EXESKEL  - Lesson  2: Win32 Basics: Win32 EXE Skeleton Application
  97.     DLLSKEL  - Lesson  3: Win32 Basics: Win32 DLL Skeleton
  98.     DLLUSER  - Lesson  4: Win32 Basics: EXE User of a DLL
  99.     COMOBJ   - Lesson  5: COM Objects: Containment and Aggregation in a DLL
  100.     COMUSER  - Lesson  6: COM Objects: Nested Aggregation in EXE User
  101.     REGISTER - Lesson  7: COM Components: Component Registration
  102.     DLLSERVE - Lesson  8: COM Components: Component DLL Server
  103.     DLLCLIEN - Lesson  9: COM Components: Client Application of DLL Server
  104.     LICSERVE - Lesson 10: COM Components: DLL Licensed Server
  105.     LICCLIEN - Lesson 11: COM Components: Client App of Licensed Server
  106.     MARSHAL  - Lesson 12: COM Components: Standard Marshaling
  107.     LOCSERVE - Lesson 13: COM Components: Local Server
  108.     LOCCLIEN - Lesson 14: COM Components: Client App of Local Server
  109.     APTSERVE - Lesson 15: COM Components: Local Server with Multiple Apartments
  110.     APTCLIEN - Lesson 16: COM Components: Client of Multiple Apartment Server
  111.     REMCLIEN - Lesson 17: COM Components: DCOM Remote Client
  112.     FRESERVE - Lesson 18: COM Components: Free-threaded Server
  113.     FRECLIEN - Lesson 19: COM Components: Client of Free-threaded Server
  114.     CONSERVE - Lesson 20: COM Components: Connectable Object Server
  115.     CONCLIEN - Lesson 21: COM Components: Client of Connectable Object Server
  116.     STOSERVE - Lesson 22: COM Components: Structured Storage Server
  117.     STOCLIEN - Lesson 23: COM Components: Client of Structored Storage Server
  118.  
  119. Throughout the sample sequence a clear differentiation is maintained
  120. between client and server, with a separate lesson sample for each.
  121. Usually, each client/server pair covers an area of COM/ActiveX technology.
  122. Here is an overview of the technologies covered by the lessons.
  123.  
  124. Basic Win32 application programming is covered in the APPUTIL, READTUT,
  125. EXESKEL, DLLSKEL, and DLLUSER lessons. APPUTIL provides a utility
  126. framework for building Win32 applications. It also contains some tools
  127. needed for tutorial purposes. READTUT is a very simple EXE application
  128. that shows how to link to the APPUTIL static library and call utility
  129. functions in it. READTUT also shows how to invoke the ActiveX tutorial web
  130. page reader that is used throughout the sample series. EXESKEL shows a
  131. basic Win32 skeleton EXE application built using APPUTIL. DLLSKEL and
  132. DLLUSER simularly show a basic Win32 DLL (Dynamic Link Library) skeleton
  133. and how to access it from an EXE user application.
  134.  
  135. Basic COM object construction, custom interfaces, and techniques for
  136. coding their reuse using aggregation and containment are covered in COMOBJ
  137. and COMUSER.
  138.  
  139. Basic COM component construction, class factories, and techniques for
  140. housing COM objects in COM component servers are covered in REGISTER,
  141. DLLSERVE, and DLLCLIEN.
  142.  
  143. COM component Licensing using IClassFactory2 is covered in LICSERVE and
  144. LICCLIEN.
  145.  
  146. Out-of-Process local servers and the standard marshaling of custom
  147. interfaces are covered in MARSHAL, LOCSERVE, and LOCCLIEN.
  148.  
  149. Multi-threaded apartment model server and client construction are covered
  150. in APTSERVE and APTCLIEN. Multiple single-threaded apartments are used.
  151.  
  152. DCOM (Distributed COM) with custom interfaces operating between client and
  153. server across machine boundaries is covered in REMCLIEN.
  154.  
  155. Free-threaded COM components and their access by free-threaded clients are
  156. covered in FRESERVE and FRECLIEN. The multi-threaded apartment is used.
  157.  
  158. Connectable COM object technology is covered in CONSERVE and CONCLIEN.
  159. Event source and sink construction is covered.
  160.  
  161. Structured storage using COM's compound file technology is covered in
  162. STOSERVE and STOCLIEN. A COM-based scribble drawing application is used.
  163.  
  164.  
  165. FILES in the Main Tutorial Directory
  166. ====================================
  167.  
  168. File          Description
  169. ----          -----------
  170. TUTORIAL.TXT  Short introduction to the ActiveX Tutorial Samples. This file.
  171. MAKEFILE      Makefile for all samples. Use only if building the entire
  172.                 samples branch WITHIN an installed Win32 Platform SDK.
  173. MAKEALL.BAT   Main batch file for building the entire samples branch
  174.                 regardless of branch's location. Use this one.
  175. REGALL.BAT    Batch file for registering all sample COM servers.
  176. UNREGALL.BAT  Batch file for unregistering all sample COM servers.
  177. CLEANALL.BAT  Batch file for cleaning all samples.
  178. TUTORIAL.EXE  The main executable entry to the web-based tutorial.
  179. TUTORIAL.HTM  Tutorial web page. Main overview of ActiveX Tutorial Samples.
  180. LESSONS.HTM   Tutorial web page. Main Tutorial lesson list (with links).
  181. ABOUT.HTM     Tutorial web page. Details about building the samples.
  182. APPUTIL.HTM   Tutorial web page covering the APPUTIL sample.
  183. APTCLIEN.HTM  Tutorial web page covering the APTCLIEN sample.
  184. APTSERVE.HTM  Tutorial web page covering the APTSERVE sample.
  185. COMOBJ.HTM    Tutorial web page covering the COMOBJ sample.
  186. COMUSER.HTM   Tutorial web page covering the COMUSER sample.
  187. CONCLIEN.HTM  Tutorial web page covering the CONCLIEN sample.
  188. CONSERVE.HTM  Tutorial web page covering the CONSERVE sample.
  189. DLLCLIEN.HTM  Tutorial web page covering the DLLCLIEN sample.
  190. DLLSERVE.HTM  Tutorial web page covering the DLLSERVE sample.
  191. DLLSKEL.HTM   Tutorial web page covering the DLLSKEL sample.
  192. DLLUSER.HTM   Tutorial web page covering the DLLUSER sample.
  193. EXESKEL.HTM   Tutorial web page covering the EXESKEL sample.
  194. FRECLIEN.HTM  Tutorial web page covering the FRECLIEN sample.
  195. FRESERVE.HTM  Tutorial web page covering the FRESERVE sample.
  196. LICCLIEN.HTM  Tutorial web page covering the LICCLIEN sample.
  197. LICSERVE.HTM  Tutorial web page covering the LICSERVE sample.
  198. LOCCLIEN.HTM  Tutorial web page covering the LOCCLIEN sample.
  199. LOCSERVE.HTM  Tutorial web page covering the LOCSERVE sample.
  200. MARSHAL.HTM   Tutorial web page covering the MARSHAL sample.
  201. REGISTER.HTM  Tutorial web page covering the REGISTER sample.
  202. REMCLIEN.HTM  Tutorial web page covering the REMCLIEN sample.
  203. READTUT.HTM   Tutorial web page covering the READTUT sample.
  204. STOCLIEN.HTM  Tutorial web page covering the STOCLIEN sample.
  205. STOSERVE.HTM  Tutorial web page covering the STOSERVE sample.
  206. ACTIVEX.GIF   Animated ActiveX graphic used by the Tutorial.
  207. NEXT.GIF      Small graphic used by the Tutorial.
  208. PREV.GIF      Small graphic used by the Tutorial.
  209. UPARROW.GIF   Small graphic used by the Tutorial.
  210. BULLET.GIF    Small graphic used by the Tutorial.
  211.