home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 December / PCWKCD1296.iso / vjplusb / activex / readme.txt < prev    next >
Text File  |  1996-07-15  |  17KB  |  340 lines
  1. This build of IE has passed BVTs.. 
  2. This ActiveX SDK build is synched to Internet Explorer Build beta2.rc8 
  3. VB Script Build Drop00Drop0007.10, and OLE Automation Build 070996.4045,  
  4. and Windows NT build v4.1365. 
  5. ============================================================================
  6. Release notes for the Microsoft ActiveX Development Kit:
  7.  
  8. Copyright (c) Microsoft Corporation, 1996
  9. ============================================================================
  10.  
  11.  
  12. Note: If you did not access this document from \INetSDK\Help\Default.htm, 
  13. that is probably a better place to begin reading documentation.  This 
  14. readme.txt is the second URL in that document's right hand frame.
  15.  
  16. -----------------------------------------------------
  17. WELCOME TO THE ACTIVEX SDK:
  18. -----------------------------------------------------
  19. Welcome to the Microsoft ActiveX Development Kit. These are the release 
  20. notes of the July '96 release of the ActiveX SDK.  It is intended to be 
  21. installed with the Beta II release of Internet Explorer 3.0, and the 
  22. May '96 release of the Win32 SDK.  The operating system for this release 
  23. of the SDK is intended to be Windows 95 or Windows NT 4.0 SUR beta.
  24.  
  25. Here's a brief description of the contents of this folder, followed
  26. by release notes.
  27.  
  28. BIN       SDK Tools, redistributables DLLs and self extracting .exe's
  29. HELP      Help files for various SDK components
  30. INCLUDE   Include files for Win32 Internet Services and OLE Interfaces
  31. LIB       Libraries for the Internet SDK
  32. SAMPLES   Internet SDK Samples
  33. SPECS     Internet SDK Documentation and Specifications
  34.  
  35. -----------------------------------------------------
  36. PREREQUISITE OF THIS RELEASE OF THE ACTIVEX SDK:
  37. -----------------------------------------------------
  38. Notes on which VC++, MFC, IE 3.0, and Win32 SDK are required.
  39.  
  40. This release of the ActiveX SDK require that you have downloaded and 
  41. installed:
  42. * Beta II of the Internet Explorer 3.0. 
  43.   (http://www.microsoft.com/ie/iedl.htm) 
  44. * The latest release of the Win32 SDK (dated May '96, available on 
  45.   MSDN Level II).
  46. * Windows 95 or Windows NT 4.0 SUR Beta
  47. * A compiler (Microsoft Visual C++ 4.1 is the most tested)
  48.  
  49. You will experience problems building code if you do not have the latest
  50.  Win32 SDK.  Before installing the latest ActiveX SDK, you should go to 
  51. the root of any past installation of the ActiveX SDK, and delete the 
  52. entire \INetSDK and it's sub-directories.
  53.  
  54. If you have Visual C++ 4.1 and the May '96 release of the Win32 SDK, you 
  55. should set your environment variables by executing the following commands 
  56. on your command line (note, make exceptions to make sure you go the the 
  57. correct directories)
  58.  
  59.   cd \msdev\bin
  60.   vcvars32 x86
  61.   cd c:\mstools
  62.   setenv c:\mstools
  63.   cd c:\inetsdk
  64.   setenv c:\inetsdk
  65.  
  66. Not having the May '96 release of the Win32 SDK is not a supported setup.
  67. If you do not have a release of the Win32 SDK, or if you have not upgraded 
  68. from the Aug.'95 release of the Win32 SDK, you will have trouble building 
  69. samples and using the current header files.  Some people have had success 
  70. by changing the order of their include files i.e. making sure that the 
  71. \msdev collection of include files come before those of the \inetsdk set 
  72. of include files.  I stress however that this is not a supported setup, 
  73. and you will likely continue to have problems.
  74.  
  75. There are some known problems with MFC 4.2 support.  If you are using
  76. MFC 4.2 and ActiveX technology, you will experience problems (as
  77. can be seen when trying to compile the UrlPad sample).  MFC 4.2
  78. support for ActiveX technology is still in beta form.  This support will
  79. be updated after the ActiveX SDK is final.
  80.  
  81. If you wish to do development for an MFC based application, you
  82. should use VC++ 4.1 and MFC 4.1; or you can use VC++ 4.2 with
  83. MFC 4.1 (their will be a tech note in your VC++ installation on
  84. how to setup this configuration: \msdev\win32s.wri).  Some people
  85. have had success using VC++ 4.2 and MFC 4.2 and changing their
  86. include paths to pick up the MFC include files first.  This will
  87. allow you to compile, but the MFC 4.2 files are not sync'd correctly
  88. with the newer ActiveX SDK libs and dlls; so you will likely
  89. continue to have problems.  Using MFC 4.2 is not supported with
  90. this release of the ActiveX SDK.
  91.  
  92. The ActiveX SDK nolonger installs DLLs (although it makes some available 
  93. for you to install yourself i.e. ULServer.dll).  It is assumed that you 
  94. have all of the DLLs needed for your ActiveX development  
  95. through your Windows NT system or Internet Explorer installation.  If this 
  96. assumption is not correct, please let us know.
  97.  
  98.  
  99. -----------------------------------------------------
  100. DigSig.dll Patch:
  101. -----------------------------------------------------
  102. In the \bin directory you will find a copy of DigSig.dll.  This is a
  103. patch to the DigSig.dll that shipped with the Internet Explorer beta II.
  104. To install it, simply copy it into you \System or \System32 directory.
  105. The system will let you do this assuming you do not have a dialog
  106. box for a certificate currently active on your screen.  You do not need
  107. to reboot the system for this installation.
  108.  
  109.  
  110. -----------------------------------------------------
  111. SOME NEW DOCUMENTATION:
  112. -----------------------------------------------------
  113. One of the changes that you will find in this SDK is a great new look
  114. with the HTML documentation.  It now uses frames and is better indexed
  115. so that you can find things easier.  You will need to be sure to have
  116. the Beta II release of Internet Explorer 3.0 to view these documents
  117. however.  Most of the HTML documentation will be found in the 
  118. \INetSDK\Help sub-directory, and can be accessed from 
  119. \INetSDK\Help\Default.htm.  You will find the HTML documentation more 
  120. generally up to date.
  121.  
  122. There is a second set of documentation in the \INetSDK\Specs 
  123. sub-directory.  This is essentially a collection of old specifications 
  124. of technology still in transition or information that has not been 
  125. converted into HTML yet.  You will find it a bit dated; but it may 
  126. still be helpful to your development efforts.  As always, with any 
  127. documentation, you should consider the header files the most recent 
  128. and the last word.
  129.  
  130. Due to many ISV requests, we have also placed the ActiveX.MVB file back
  131. into the ActiveX SDK.  We had initially thought ISVs would not want to 
  132. download this file due to size reasons, but feedback has indicated that
  133. it is well worth the download time to be able to use .mvb files and a 
  134. search engine.  You will find it in the \INetSDK\Help sub-directory. 
  135.  
  136. Note, if you are having trouble finding an old .doc or .txt file, chances
  137. are it has been folded into the new .htm or .mvb files.  If you're not
  138. finding things where you think they should be located, please give us 
  139. feedback.  If we get enough feedback to indicate a change is needed to 
  140. the documentation structure, we will make it.
  141.  
  142. Some notable additions to the documentation are information on Steps on 
  143. making a control, Licensing, and Pallete issues.  
  144.  
  145. There is another new file called RegSet.txt found in \INetSDK\Bin.  It is 
  146. meant to demostrate the registry settings for URLMon.dll, WinInet.dll, 
  147. and other files.  It is in the form of an .inf file (it is actually 
  148. extracted from the Internet Explorer and redistributable's .inf files.)  
  149.  
  150. -----------------------------------------------------
  151. SOME NEW TOOLS:
  152. -----------------------------------------------------
  153. There are a couple of new tools that you will find useful in your 
  154. development.  
  155.  
  156. * LPK_Tool: is a Licensing Package Authoring Tool, that 
  157.   allows you to create   a license package (LPK file) for the controls of 
  158.   a given web page.  To learn more, look for the lpk_tool.* files in your 
  159.   \inetsdk\bin directory.
  160.  
  161. * ActiveX Control Pad: is a much easier way to add controls to your pages.  
  162.   The ActiveX Control Pad is not a part of the ActiveX SDK download 
  163.   available from the internet; however, if you don't have it already, you 
  164.   can access it from a URL found on the \inetsdk\help\Overview.htm (that 
  165.   jump is back one jump from here), or find it from in your browser as 
  166.   http://www.microsoft.com/workshop/author/cpad/cpad.htm.
  167.  
  168. * There are two new .reg files (and a readme: reg.txt) used to turn 
  169.   registry settings on and off allowing the use of fake certificates for 
  170.   signed code.  When Internet Explorer is released to manufacture, this 
  171.   registry setting will be turned off, so that end-users will not see the 
  172.   popup fake certificate that developers are currently using to test
  173.   signed code.  By executing these registry files, a developer can turn 
  174.   the registry settings on so that their machine can test for signed code 
  175.   when using a fake certificate. Files added to \INetSDK\Bin are: Reg.txt, 
  176.   wvtstoff.reg, wvtston.reg.
  177.  
  178. * ShowKeys.exe is a new tool in the use of code signing.  ShowKeys will
  179.   provide you with a list of your own signing keys in your certification
  180.   store (for both code signing and client authentication)
  181.  
  182. -----------------------------------------------------
  183. SOME NEW SAMPLES:
  184. -----------------------------------------------------
  185. There a couple of new samples available for WinInet developers.  They are
  186. HTTPAuth and HeadDump.  You will find them both in the 
  187. \InetSDK\Samples\WinInet sub-directory.
  188.  
  189. The ActiveX Conferencing samples (\INetSDK\Samples\MSConf) have been 
  190. refreshed from the latest Conferencing SDK, and you will find new 
  191. information on ULS in that samples subdirectories.
  192.  
  193. The WebPost samples have also been refreshed.
  194.  
  195. -----------------------------------------------------
  196. SOME CODING TIPS:
  197. -----------------------------------------------------
  198. Under the category of "Ghee, if I had only known...", the following is 
  199. some helpful coding tips of things that have changed or things others 
  200. have discovered in their development cycles and want others to know about.
  201.  
  202. * A Change with OnData methods between Beta I and Beta II.
  203.   If you've written your controls based off of the WebImage sample
  204.   you will need to change your OnData method implementation and recompile.
  205.   Please look at the current WebImage sample for details.
  206.  
  207.   The old sample was written to use a Push model implementation of
  208.   UrlMon.dll.  The current ActiveX framework has been changed to use the 
  209.   Pull model (more efficient).
  210.  
  211. * Passing Hexidecimal Values into Controls.
  212.   If you are having trouble with passing hexidecimal values into controls, 
  213.   it may be because you are not using the VB syntax for specifying the hex 
  214.   numbers, example:
  215.     <param NAME="DisplayForeColor" Value="&hFFFF">
  216.  
  217. * New Syntax for Floating Frames
  218.   There is a new syntax for floating frames.  This means existing floating 
  219.   frame pages will not work and need to be updated immediately. The <frame> 
  220.   tag is no longer used to create a floating frame, <iframe> is used instead 
  221.   (iframe stands for inline frame). 
  222.  
  223.   The other change is that <iframe> is a container tag, so you must add a 
  224.   matching </iframe> for each floating frame. Any html in the <iframe> 
  225.   container will be ignored by Internet Explorer 3.0, but other clients 
  226.   (such as NetScape 3.0) will ignore the <iframe> tag and show the 
  227.   contained html. This is a big win, because it will allow people 
  228.   to author pages that play well in different browsers and Internet 
  229.   Explorer.
  230.  
  231.   Authoring a page with floating frames that works in beta 1 and beta 2 
  232.   Is quite easy to do. Take the following example:
  233.     <frame src="foo" name="floater" width=80% height=200 align=left>
  234.   It can be updated to work in beta 2 only by changing it to:
  235.     <iframe src="foo" name="floater" width=80% height=200 align=left>
  236.     </iframe>
  237.   If compatibility with beta 1 and beta 2 is needed, change it to:
  238.     <iframe src="foo" name="floater" width=80% height=200 align=left>
  239.       <frame src="foo" name="floater" width=80% height=200 align=left>
  240.     </iframe>
  241.  
  242.   Note that this last example works because beta 1 ignores the <iframe> 
  243.   tags and beta 2 ignores the <frame> tag contained in the <iframe> 
  244.   container.
  245.   
  246. * Urlmon.dll has gone through a lot of changes, a lot of functionality 
  247.   found in other files (like Urlhlink.lib, HLinkEZ.dll or UrlMonEZ.dll) 
  248.   has now been folded into Urlmon.dll.  This is one reason you must be sure 
  249.   to have the new release of Internet Explorer.
  250.  
  251. * ActiveX Framework Asserts occur in Tstcon32 or ODS_Tool: CtlView.cpp, 
  252.   Line 120.  Currently if you build a debug version of a control based off 
  253.   of the INETSDK ActiveX Framework, and insert it into the Tstcont32.exe 
  254.   control test container (shipped with VC++ 4.1) or insert it into the 
  255.   ODS_Tool.exe from the SDK, both will bring up the following assert when 
  256.   the control is loaded.
  257.  
  258.     Inplace active and sombody passed in prcBuunds!!!
  259.     File CtlView.cpp, Line 120
  260.  
  261. ============================================================================
  262. SOME OLD NEWS WITH NEW CHANGES: REDISTRIBUTABLE DLLs.
  263. ============================================================================
  264. WINTDist.exe and AXDist.exe
  265. -----------------------
  266. The following files are now redistributable via WINTDist.exe and AXDist.exe:
  267. SChannel.dll, WinInet.dll, InLoader.dll, URLMon.dll, HLink.dll, HLinkPrx.dll, 
  268. StdOLE2.tlb and OLEAut32.dll.  The purpose of making the redistributable is 
  269. so that ISVs can ensure their ActiveX code will run on target machines 
  270. without Internet Explorer 3.0 installed on them.  They install the DLLs and 
  271. their dependencies in the proper directories, and make the proper registry 
  272. entries.  These DLL are ONLY redistributable through the use of WINTDist.exe 
  273. and AXDist.exe, see details on redistribution rights in 
  274. \doc\redist\redist.txt. (This directory is not installed with the ActiveX 
  275. SDK, it is on your source image i.e. the same place you executed 
  276. SetupSDK.exe from.) 
  277.  
  278. These files work on Windows NT 4.0 and Windows 95.  They do not yet work
  279. on Windows NT 3.51.  WINTDist.exe will work on Windows NT 3.51 in a future
  280. ActiveX SDK release.
  281.  
  282. A change since the last release of the ActiveX SDK: these .exe files no 
  283. longer prompt a reboot after running; but if you use them in your setup 
  284. program, you must prompt the user to reboot after finishing your setup 
  285. program so that the proper effects can take place.  More changes are that
  286. these files no longer display dialog boxes or windows, they should be
  287. completely unobtrusive.
  288.  
  289. WINTDist installs WinInet.dll, SChannel.dll, InLoader.dll, and makes 
  290. required registry entries.  You may ship WINTDist.exe with your finished 
  291. products, even though the WinInet.dll is still in beta form.  You do not 
  292. have to mark your product as "Beta" (note, this is a change from the 
  293. original licensing agreement)  However, if you do ship this version of 
  294. WINTDist.exe, you are obligated to refresh your customer base with the 
  295. final version of WinInet.dll (via WINTDist.exe) with your next product 
  296. upgrade.  Note this is also a change from the original licensing agreement 
  297. which specified upgrading within 90 days of the final release of WinInet.dll 
  298. and WINDist.exe.
  299.  
  300. To test your WinInet code with these redistributables:
  301. * Start with a clean Windows 95 or Windows NT machine <without SDKs or
  302.   Internet Explorer installed>.
  303. * Run WINTDist.exe
  304. * Run and test your code.
  305.  
  306. AXDist.exe installs WinInet.dll, InLoader.dll, URLMon.dll, HLink.dll, 
  307. HLinkPrx.dll StdOLE2.tlb, OLEAut32.dll, SChannel.dll.  All of these files 
  308. are needed in order to allow URLMon code to run correctly.  You may ship 
  309. AXDist.exe with your product, but must mark that product as "Beta".  If 
  310. you redistribute this version of URLMon.dll via AXDist.exe with your product, 
  311. you are obligated to upgrade that product within 90 days of the final 
  312. release of URLMon.dll and AXDist.exe.
  313.  
  314. To test your URLMon code with these redistributables: 
  315. * Start with a clean Windows 95 or Windows NT machine <without SDKs or
  316.   Internet Explorer installed>.
  317. * Run AXDist.exe
  318. * Run and test your code.
  319.  
  320. Alternately, for testing your code, do the following:
  321.  
  322. To test these files: 
  323. * Start with a clean Windows 95 or Windows NT machine.
  324. * Install the Win32 SDK (a release dated May '96 or later).  
  325. * Install the ActiveX SDK (dated July '96 or later).  
  326.   <note, the Internet Explorer should not be installed>
  327.  
  328. then ... For WinInet only code:
  329. * Run WINTDist.exe to install WinInet.dll and dependencies.
  330. * Build and run your WinInet.dll dependent code.
  331.  
  332. or/then ... For URLMon code:
  333. * Run AXDist.exe to install the rest of the files described
  334.   above.
  335. * Build and run your code.
  336.  
  337. Note, if the redistributables don't meet your distribution needs, report
  338. problems to AXDistB1@microsoft.com
  339.  
  340.