home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 June / Chip_2001-06_cd1.bin / zkuste / vbasic / Data / Utility / MSISDK15.msi / ReadMe.txt < prev    next >
Text File  |  2000-11-14  |  11KB  |  189 lines
  1. Windows Installer 1.5 SDK Release  -  Microsoft Corporation 
  2.  
  3. ---------------------------------------------------------------------------
  4. This release includes the following components, in the indicated folders:
  5.  
  6.     ReadMe.txt         - this file, contents and notes
  7.     License.rtf        - SDK license agreement
  8.     Redist.txt         - redistibution terms and conditions
  9.  
  10. Redist - components that may be redistributed with your application
  11.     WINNT\InstMsi.exe     - Windows Installer self-installer for use with Windows NT4 and Windows 2000
  12.     WIN9x\InstMsi.exe     - Windows Installer self-installer for use with Windows 95, Windows 98, Windows ME
  13.  
  14. Help
  15.     Msi.chm+Msi.chi    - Documentation for Windows Installer, HTML help format (see note below)
  16.  
  17. Include
  18.     Msi.h        - install management API functions
  19.     MsiQuery.h         - database and custom action API functions
  20.     MsiDefs.h          - property names and database data bit flags
  21.     MergeMod.h         - definitions for use with MergeMod.dll COM object
  22.     PatchApi.h         - definitions for use with MsPatchC.lib and MsPatchC.dll
  23.     PatchWiz.h         - definitions for use with the installer patch package creation tool
  24.  
  25. Lib
  26.     Msi.lib             - import lib for MSI API functions
  27.     MsPatchC.lib    - import lib for patch generation engine MsPatchC.dll
  28.     PatchWiz.lib     - import lib for patch package creation tool PatchWiz.dll
  29.  
  30. Tools
  31.     Instlr11.adm       - used with the Group Policy Editor. See the "System Policy" help topic.
  32.     Instlr1.adm           - used with the Group Policy Editor and Windows Installer version 1.0
  33.     Orca.msi         - graphical table editor supporting validation and merge modules
  34.     MsiVal2.msi      - command-line installer package validation tool, provides darice.cub and logo.cub files
  35.     MsiDb.exe        - database import, export, merge, transform
  36.     MsiMig.dll          - Custom Action for migration of 1.0 cached packages to 1.1 of the Windows Installer
  37.     MsiMig.exe          - Command line utility for administrators migrating 1.0 cached packages to 1.1
  38.     MsiMsp.exe        - patch package creation
  39.     MsiInfo.exe      - summary information property manager, string pool validation
  40.     MsiMerg.exe      - merges two databases
  41.     MsiTran.exe      - generates and applies database transforms
  42.     MsiZap.exe       - used to remove selected MSI management data from a machine. Use with caution.
  43.     MsiCert.exe         - used to populate the MsiDigitalSignature and MsiDigitalCertificate tables
  44.     MsiFiler.exe        - used to populate file versions, sizes, and languages
  45.     MsiTool.mak        - shared makefile for tools and custom actions
  46.     MergeMod.dll    - COM object providing support for installer merge modules
  47.  
  48. Tools\110
  49.     darice.cub          - Windows Installer version 1.1 complete validation suite
  50.     mergemod.cub        - Windows Installer version 1.1 merge module validation suite
  51.     logo.cub            - Windows Installer version 1.1 logo validation suite
  52.  
  53. Tools\120
  54.     darice.cub          - Windows Installer version 1.2 complete validation suite
  55.     mergemod.cub        - Windows Installer version 1.2 merge module validation suite
  56.     logo.cub            - Windows Installer version 1.2 logo validation suite
  57.  
  58. Web
  59.     msistuff.exe        - used to populate resources in setup.exe.  Only works on Windows NT.
  60.     setup.exe           - internet download executable for creating installs from the web
  61.  
  62.  
  63. Patching
  64.     MakeCab.exe          - general compressed file cabinet generation tool, not installer-specific
  65.     MPatch.exe       - test application to create a patch file using MsPatchC.dll
  66.     APatch.exe       - test application to apply a patch using MsPatchA.dll (part of InstMsi package)
  67.     MsPatchC.dll    - patch file creation engine, used by PatchWiz.dll and MPatch.exe
  68.     PatchWiz.dll     - installer patch package creation tool (documented in Msi.chm)
  69.     Template.pcp    - schema for patch wizard project settings
  70.     Example.pcp      - sample project settings for patch wizard
  71.  
  72. Database
  73.     Schema.msi       - database containing all standard tables, but no installation data
  74.     Schema.msm       - merge module containing all standard module tables, but no installation data
  75.     Sequence.msi     - recommended sequence table actions
  76.     UISample.msi    - sample database demonstrating a UI implementation         
  77.     Error.mst        - transform to provide debug error messages during development
  78.     Intl             - localized Error and ActionText tables in multiple languages
  79.     
  80. Database\100
  81.     Schema.msi       - Windows Installer version 1.0 database containing all standard tables
  82.     Sequence.msi     - Windows Installer version 1.0 recommended sequence table actions
  83.  
  84. Database\110
  85.     Schema.msi          - Windows Installer version 1.1 database containing all standard tables
  86.     Sequence.msi        - Windows Installer version 1.1 recommended sequence table actions
  87.     Schema.msm          - Windows Installer version 1.1 merge module containing all standard module tables
  88.  
  89. Database\120
  90.     Schema.msi          - Windows Installer version 1.2 database containing all standard tables
  91.     Sequence.msi        - Windows Installer version 1.2 recommended sequence table actions
  92.     Schema.msm          - Windows Installer version 1.2 merge module containing all standard module tables
  93.  
  94. Samples - examples demonstrating the use of the Windows Installer APIs
  95.     Create.cpp          - sample DLL custom action for creating user accounts on the local machine
  96.     CustAct1.cpp     - sample DLL custom action for testing
  97.     CustExe1.cpp     - sample EXE custom action for testing
  98.     MsiLoc.cpp          - sample resource file generation and import tool (export an msi for use with localization of .RES files)
  99.     MsiLoc.txt          - readme for msiloc.cpp and usage of the corresponding compiled exe
  100.     MsiMerg.cpp      - sample database merge tool
  101.     MsiTran.cpp      - sample transform creation and application tool
  102.     Process.cpp         - sample DLL custom actions (ProcessUserAccounts, UninstallUserAccounts) for user account creation and deletion
  103.     Remove.cpp          - sample DLL custom action for removing user accounts from the local machine 
  104.     Scripts         - folder containing doc and scripts to perform a variety of installer-related tasks
  105.     Tutorial.cpp        - sample DLL custom action for invoking an installed file at the end of setup
  106.  
  107. ---------------------------------------------------------------------------
  108. Windows Installer core files installed by installation package InstMsi.exe:
  109.     Msi.dll        - installation engine, use by install clients and install service
  110.     MsiExec.exe        - command-line invocation of install functions, and service control functions
  111.     MsiHnd.dll        - UI process, loaded only when full UI is authored and used for installation
  112.  
  113. Other files that are updated as needed by installation package InstMsi.exe:
  114.     riched20.dll, usp10.dll, msls31.dll    - rich-edit and complex script support
  115.     cabinet.dll              - extraction of files from compressed file cabinets
  116.     imagehlp.dll             - used for import table binding
  117.     mspatcha.dll             - used to apply file-level patches
  118.     shfolder.dll             - special shell folder location and creation
  119.  
  120. ---------------------------------------------------------------------------
  121. Notes: 
  122.  
  123. Msi.chm is the primary source of information about the Windows Installer, and contains both an 
  124. introduction to the new model, as well as detailed reference material for developers.
  125. See the topic "Windows Installer Examples" to get started with simple packages.
  126.  
  127. If HTML help is already installed on your system, msi.chm can be invoked via file association
  128. HTML help can be installed from: http://msdn.microsoft.com/workshop/author/htmlhelp/localize.asp
  129.  
  130. The .msi packages in the SDK may be installed by activating them in the Windows Explorer,
  131. or by using "MsiExec.exe -i path_to_package". Use "MsiExec.exe -?" to see more options.
  132. The object model is exposed as the ProdId: WindowsInstaller.Installer
  133.  
  134. UISample.msi provides a sample UI sequence, but that sequence will not function
  135. properly until the database has been populated with valid installation data.
  136. For help in populating a database with valid installation data, see the help topic
  137. titled "An Installation Example" under "Windows Installer Examples". For an
  138. example of a completed installation package that uses the same UI sequence as
  139. UISample.msi, install one of the msi packages under the Tools or SampProd folders.
  140. Set the ShowUserRegistrationDlg property in the Property table to 0 if you do not
  141. wish to have the UserRegistrationDlg appear.
  142.  
  143. UISample.msi together with Sequence.msi and schema.msi will provide a framework which can
  144. then be populated with valid installation data.  Use the MsiMerg tool, MsiDb tool or the
  145. WiMerge.vbs script to merge the databases together (merging two at a time).
  146.  
  147. The custom action samples process.cpp, remove.cpp, create.cpp, and tutorial.cpp are the source
  148. files for the sample custom actions described in the msi.chm file.  See the msi.chm file for
  149. more information regarding their usage.
  150.  
  151. ---------------------------------------------------------------------------
  152. Compiling sample code:
  153.  
  154. There are two options for compiling the sample code in the Samples subfolder:
  155. use nmake or use a project in the MSDev environment.
  156.  
  157. To use nmake, make certain that the MSVCDIR environment variable is set. You can
  158. generally run the VCVARS32.BAT to set this. VCVARS32.BAT is located in the BIN
  159. subdirectory of your VC install. The command line to compile the CUSTACT1.CPP
  160. sample file (given default install locations for both Microsoft Visual C++ 6
  161. and the Windows Installer SDK) would look like this:
  162. C:\program files\MsiIntel.SDK\Samples> nmake -f custact1.cpp include="%include%;c:\program files\MsiIntel.SDK\Include" lib="%lib%;c:\program files\MsiIntel.SDK\Lib"
  163. Note: the quotes are included because the default install locations include spaces in path names.
  164. If the INCLUDE and LIB environment variables on the machine and the SDK install location
  165. do not have spaces in the path, then the quotes are unnecessary.
  166.  
  167. To use the MSDev environment, create a new Win32 EXE or Win32 DLL project, and
  168. add the appropriate file as a source. MSI.LIB will need to added to the library
  169. list in the Project Settings dialog. MsiIntel.SDK\Include and MsiIntel.SDK\Lib
  170. directories will need to be added to the Directories tab under Tools\Options.
  171.  
  172. All SDK source files contain comments on how to compile the sample code.  See the
  173. source file for more specific build information.
  174.  
  175. Note that initmsi.cpp does not compile.
  176.  
  177. ---------------------------------------------------------------------------
  178. Known issues:
  179.  
  180. Msi.chm is not yet properly integrated w/ the typelib in msi.dll - context sensitive 
  181. help is not available in VB w/ this release.
  182.  
  183. Tools that create customization transforms require special considerations that are
  184. not yet documented in msi.chm.  A KB article on this topic will be published
  185. shortly after this SDK is released - go to http://support.microsoft.com/support/search/c.asp
  186. and enter "Q225522" in the "My Question Is" box.
  187.  
  188. Additional support articles and solutions will be placed on 
  189. http://support.microsoft.com/support/search/c.asp as they become available.