INFO: Readme.txt for Internet Client SDK
ID: Q167837
|
The information in this article applies to:
-
Internet Client SDK, version 4.0
SUMMARY
The following article contains the complete contents of the Readme.txt file
distributed with the Internet Client SDK version 4.0. (This is the
Readme.txt installed on the \InetSDK folder.)
MORE INFORMATION
=======================================================================
Release notes for the Internet Client Software Development Kit
Copyright (c) Microsoft Corporation, 1997
=======================================================================
NOTE: If you did not access this document from <your SDK
folder>\help\default.htm, go to that location because it is a better
place to begin reading documentation.
This Readme.txt is the second URL in that document's left-hand frame. If
you are unfamiliar with the Internet Client SDK, you might want to look at
the Overview section. There is a great deal of new material and
technologies available through that section.
-----------------------------------------------------
WELCOME TO THE INTERNET CLIENT SDK
-----------------------------------------------------
These are the release notes for the Internet Explorer 4.0 version of the
SDK. This release has been tested primarily on Visual C++ 5.0, Windows 95
and Windows NT, and Internet Explorer 4.0 releases.
Here's a brief description of the contents of this folder, followed by
release notes:
BIN SDK tools, DLLs, and self-extracting .exe files
HELP HTML documentation (Default.htm) for Web content and software
development
INCLUDE Include files for Internet development
LIB Libraries for Internet development
SAMPLES Samples for Web content developers and software developers
COMPLIB Internet components (ActiveX Controls, Java applets, and so
on)
-----------------------------------------------------
PREREQUISITES OF THIS RELEASE OF THE SDK
-----------------------------------------------------
To do development with this SDK, you need to have installed on your
computer:
- Internet Explorer 4.0.
- If you are developing software, the latest Win32 development files. You
might already have installed these from the latest Platform SDK at
http://www.microsoft.com/msdn/sdk/. Otherwise, the
subset you need is available as a download from the Internet Client SDK
download page under "Win32 SDK Libraries & Headers."
- Windows 95 or Windows NT 4.0 SUR (final version).
- Development tools, if you are building software. This product
has been tested primarily on Visual C++ 5.0. (See "Configuration Issues"
below for more information.)
Installing the SDK on Memphis Beta 1 hasn't been fully tested. If you try
this, you must upgrade the Memphis release with the latest Internet
Explorer 4.0 release.
-----------------------------------------------------
INSTALLATION ISSUES -- CD AND INTERNET INSTALLS
-----------------------------------------------------
ActiveSetup from the Internet:
Essentially the ActiveSetup from a CD is identical to the ActiveSetup from
the Web. One difference is that the CD will have an image of a fully
installed SDK. If for some reason you are unable to use ActiveSetup, this
should not prevent you from being able to use the documentation and seeing
the samples. Copying those files from the CD to your hard drive (without
using ActiveSetup) is not a supported method of installation.
The new Web site for installing the SDK is:
http://www.microsoft.com/msdn/sdk/inetsdk/ASetup/
The download site is designed to allow you to download the bits that you're
interested in, while ignoring the others for another day. You can return to
the site for incremental downloads that nicely integrate into your
installation. The downloads are targeted at three major development
tasks/audiences: Web and Desktop Content Providers, ActiveX Component
Developers, and Internet Application Developers. There is also a Component
Library with helpful Internet components such as the Microsoft Chat and
NetShow controls. A useful feature of the documentation is that it
integrates well on the client computer. If you make a jump from the
documentation to a set that you have not yet installed, the documentation
will invite you back to the download site to install that documentation
set. When you do this, the links will be resolved to the new pages.
-----------------------------------------------------
GETTING STARTED ON DOCUMENTATION
-----------------------------------------------------
The documentation has lots of great new content. The entry point is <your
sdk dir.>\help\default.htm. All documentation should be accessed through
this file. Accessing other HTML files directly will cause scripting errors
and break navigation links.
-----------------------------------------------------
CONFIGURATION ISSUES
-----------------------------------------------------
If you have Visual C++ 5.0 and the latest release of the Platform SDK, you
should set your environment variables by executing the following commands
on your command line (note: make exceptions to make sure you go to the
correct directories):
cd \vc\bin
vcvars32 x86
cd c:\mstools
setenv c:\mstools
cd c:\inetsdk
setenv c:\inetsdk
If you have Visual C++ 5.0 and installed the Win32 development files from
the Internet Client SDK, you should set your environment variables by
executing the following commands on your command line (again note: make
exceptions to make sure you use the correct directories):
cd \vc\bin
vcvars32 x86
cd c:\inetsdk
setenv c:\inetsdk
If a set of Win32 development files wasn't found in either case, you will
be warned not to pursue development.
If you are developing on a Windows 95 computer, you will want to increase
your environment space. You can do this by changing "Initial environment"
on the "Memory" tab of the "Properties" menu, which is accessible by
clicking in the extreme upper-left corner of your MS-DOS prompt window.
-----------------------------------------------------
BUILDING/USING SAMPLES
-----------------------------------------------------
For both software and content developers, the samples are located in the
\samples directory, and are often referenced in the documentation as
examples. The Samples.htm file (accessible from Default.htm) provides more
detailed information about each sample.
You will find several new samples targeted at content development. These
are not the traditional type of samples that use compilers or linkers--
these are HTML and CDF samples, and others, that show you how to use or
develop content on Web pages.
For software developers, each sample that produces a binary has a makefile
in its directory. You can execute all of these recursively by executing
...\samples\makeall.bat. All samples should build on Visual C++ 5.0.
Several of the ChatOCX samples are Visual Basic samples. You will need to
have Visual Basic installed to build and execute these samples.
-----------------------------------------------------
WHAT'S IN THE \BIN DIRECTORY
-----------------------------------------------------
Lots of new, good stuff!
Many of the following are self-extracting CAB files; you can read more
about them in the documentation or in the .txt files in the \bin directory.
Upon download, these file are installed in either the \bin directory of
the \complib directory.
- Microsoft Agent files: ACE.exe (a character editor), and Liset.exe
(linguistic sound).
- CDCache.exe: A tool that allows you to create a cache container so you
can reference resources off of a CD-ROM. (see documentation in the
Internet Tools and Technology section of the SDK).
- CDFTest.exe, CDFTest.txt: A program that will take a CDF file or OSD
file and verify its structure and syntax. It will find and report
mistakes such as missing end tags as well as incorrect or misspelled
tags.
- XMLint.*, XMLint.txt: A tool that checks whether an input file (or URL)
is a well formed XML file.
- StyleT.exe, StyleT.htm: A CSS Style Sheet Validation Tool. This allows
you to: Ensure the syntax of CSS Style Sheets (and Inline Styles) is
valid, Verify they conform to the W3C CSS Specification, Identify the
usage of CSS extensions supported by Microsoft Internet Explorer.
- Chkjava.exe and Javasign.dll: Tools for signing Java permissions (see
notes below).
- Updated MIDL compiler.
- Cdllogvw.exe, Cdllogvw.txt: A useful tool to view error logs during
downloads.
- CDFGen.exe: Microsoft CDF Generator (previously known as Liburnia.exe):
This is a CDF creation wizard.
- Wmfcnv.exe, wmfcnv.txt: Windows metafile converter.
- Cab-sdk.exe: The cabinet development kit components. (self-extracting
cab)
- Nm20sdk.exe: The NetMeeting version 2.0 SDK components. (self-extracting
cab)
- Ns*.exe: Various NetShow tools and demonstrations. (self-extracting cab)
- Wpsdk.exe: WebPost DLLs to be used if you build the WebPost samples or
do WebPost development. (self-extracting cab)
- Lpk_tool.exe, Lpk_tool.txt, Lpk_tool.hlp: A tool that generates
licensing package files for use with licensed ActiveX Controls.
- New code signing tools for Authenticode 2.0 (see Known Issues below):
cert2spc.exe, certmgr.exe, chktrust.exe, imagehlp.dll, makecert.exe,
makectl.exe, msvcrt.dll, setreg.exe, signcode.exe, signer.dll.
-----------------------------------------------------
WHAT'S IN THE \CompLib DIRECTORY
-----------------------------------------------------
- Chatcntl.exe, MSChat1j.exe: Microsoft Chat Control and Microsoft Chat
Java applet.
- Nlaudio.ocx and Nlfile.ocx: NetShow controls.
- Mdac*.exe, Mdac.txt: The Microsoft Remote Data Access components for the
server (formerly ADC). (self-extracting cab)
- MSAgent.exe, CGram.exe, Actcnc.exe: Files for Microsoft Agent, including
speech files.
-----------------------------------------------------
KNOWN ISSUES OR BUGS
-----------------------------------------------------
MSTASK.H:
The Task Scheduler interface introduced during beta as ISchedulingAgent has
been renamed to ITaskScheduler in the final release of the product. This is
FYI only, no recompile is necessary.
BLEND TRANSITION - CSS:
Attempting to assign a shape value (for example, Box-In, Wipe-Left) in a
script to a Blend transition causes Internet Explorer to GPF. Don't do
this. Setting a shape value to a Blend Transition in CSS is ignored.
This will most likely happen when authors are editing code that changes a
Reveal Transition to a Blend Transition without taking out any code that
sets the transition shape.
BINDINFO and ATL:
The BINDINFO structure has changed size between Internet Explorer 3.x and
Internet Explorer 4.0. There are more details in the documentation for
BINDINFO that tells how to check this structure and how it applies to your
code.
Some of the ATL samples in this SDK--Glass, IEMime, and TDC for example--
use classes based on the ATL CBindStatusCallback class, which implements
asynchronous moniker downloads. The version of ATL shipping with Visual C++
5.0 fails to release some interfaces and handles the size of the BINDINFO
structure incorrectly inside CBindStatusCallback. The Glass IEMime and TDC
samples are not affected because they provide their own revised
CBindStatusCallback implementations. However, any customers who create
projects based on these SDK samples but use CBindStatusCallback directly
should be aware of these issues. ATL users should also be aware. Microsoft
is currently planning to resolve these problems in a future Service Pack
for Visual Studio.
OBJBASE.H
CoCreateStandardMalloc is defined in the Objbase.h header file, however
this function is obsolete and will be removed in a future release.
Attempting to use this in your code will generate unresolved symbol errors
during linking. CoGetMalloc should be used instead.
-----------------------------------------------------
LATE BREAKING DOCUMENTATION UPDATES
-----------------------------------------------------
AUTHENTICODE RELEASE NOTES:
The following functionality has been added to the CertMgr program.
Putting Certificates, CTLs, and CRLs with CertMgr
The following syntax can be used to invoke CertMgr to put an X509 encoded
certificate, CTL, or CRL into a file:
CertMgr -put [options] [-s [-r registryLocation]] SourceStore FileName
SourceStore is the source certificate store that contains the existing
certificates, CTLs, and CRLs. FileName is the file to which an X509 encoded
certificate, CTL, and CRL will be saved. If the -7 option is used, the file
will be saved as a PKCS#7.
CertMgr can put either certificates, CTLs, or CRLs. If there is more than
one item in one of these categories, the user has two options:
1. Use the -n and -sha1 options to uniquely identify the item.
2. Do not specify any options, and CertMgr will prompt the user with a list
of items to put. The user responds by entering the index of the item to
add.
The options are:
-c Put certificates.
-CTL Put CTLs.
-CRL Put CRLs.
-7 Save the certificate, CRL, or CTL as a PKCS#7.
-e encodingType Certificate encoding type.
-y storeProviderType Store provider type.
-f dwFlags Store open flag. This is the dwFlags parameter
passed to CertOpenStore. The default value is
CERT_SYSTEM_STORE_CURRENT_USER. Meaningful only
if -y is set. For more information see the
CryptoAPI 2.0 documentation.
-n commonNameString The common name of the certificate to
put. Can be used only with certificates.
-s Indicates the SourceStore is a system store. If
this option is not set, the store is a
StoreFile.
-sha1 sha1Hash The SHA1 hash of the certificate, CTL, or CRL to
add.
-r registryLocation Identifies the registry location of the system
certificate store. Meaningful only when -s is
set. Must be set to either currentUser or
localMachine. CurrentUser is the default.
currentUser means that the certificate store is
under the registry key HKEY_CURRENT_USER,
localMachine means HKEY_LOCAL_MACHINE.
-? Displays all the options.
The following example puts an X509 encoded certificate, that is located
in the Root certificate store, to a file called newCert.cer. The
certificate's common name is "myCert".
certmgr -put -c -n myCert -s root newCert.cer
UPDATE/CORRECTIONS TO DHTML FILTERS AND TRANSITIONS DOCUMENTATION:
- When chaining together filters and transitions, it is advised that
transitions be specified at the end of the list.
- Under the section titled, "Properties, Methods, and Events" it lists
Duration and Status as transition properties. There should also be
listed the Enabled property, which is present on all visual filters and
transitions. A value of FALSE will disable the visual filter or
transition. A value of TRUE means the visual filter or transition is
active. The default value is TRUE. This value can be set both in the
style sheet and through script.
- The Enabled link on the Filters and Transitions page mistakenly jumps
to the Enabled property for the Active Move control
- In the overview for Transitions, the Play and Stop links mistakenly
jump to the Play and Stop properties for the NetShow Player Audio
control. Jumping to the link will also install the control if it hasn't
already been installed.
- In the Creating Multimedia Effect With Visual Filters and Transitions
section, the Duration link mistakenly jumps to the Duration property
for the NetShow Player Audio control. Jumping to the link will also
install the control if it hasn't already been installed.
- The first "Show Me" example uses improper syntax:
<img id=sample src="sample.jpg" style="filter:blur(amount=2)
flipv()">
should be:
<img id=sample src="sample.jpg" style="filter:blur(strength=2)
flipv()">
- The Glow filter's Strength property has a range from 1 to 255, not 0 to
100.
- The example for the sentence, "Timers create cyclical effects, as in
the following interactive demonstration." is not a good example. It
does not work as intended.
- The Transition Wizard may produce a scripting error when trying to
demonstrate the code generated. This is only a problem when showing how
the code works within the Wizard. The code it generates will work
normally when cut-and-copied to an HTML document.
- Disregard the explanatory text after the list of filter names under the
Visual Filters subheader under Visual Transition Filters Reference.
Additional query words:
Keywords : kbreadme AXSDKMisc
Version : WINDOWS:4.0
Platform : WINDOWS
Issue type : kbinfo