Help and Support

PRB: HTML Help Shortcuts May Fail When You Use Version 1.4 or Later

Article ID:323180
Last Review:February 1, 2007
Revision:3.2
This article was previously published under Q323180
On This Page

SYMPTOMS

HTML Help supports a command named shortcuts. This command permits the user to run an executable file from a compiled help file. In HTML Help version 1.4 and later, some shortcuts may not work.

Back to the top

STATUS

This behavior is by design. This change in functionality was made to improve security.

Back to the top

MORE INFORMATION

The following are some of the reasons that shortcuts may not work:
The .chm file does not exist in the Local Machine zone. For example, the .chm file exists on a UNC path or on a mapped network drive.

Microsoft Internet Explorer uses zones to specify different levels of security. The Local Machine zone is an implicit zone for content that is on the user's computer. Internet Explorer identifies content that is on a UNC path or on a mapped network drive to be in the Intranet zone.
The shortcuts have been limited by a group policy, either by the local computer or by a Group Policy Administrator for the domain.
a. If no group policy exists (this is the default), shortcuts will work only if the .chm file is in one of the following directories (or in a subdirectory of one of these directories):
Windows Directory\Help
Windows Directory\PCHEALTH\HELPCTR
PROGRAMFILES
NOTE: By default, on older operating systems (such as Windows NT 4.0 and Windows 95), if the .chm file is in the Local Machine zone, all shortcuts work unless the help policy is set.
b. If a group policy exists, either for the local computer or for an organizational unit to which the computer belongs, HTML Help observes the following rules:
If the policy does not exist, or if the policy is not configured, the default behavior is used (see part a of this list item)
If the policy is turned on, but no directories are specified in the policy dialog box, shortcuts do not work.
If the policy is turned on and there are directories specified in the policy dialog box, HTML Help verifies that the .chm file is in one of the specified directories (or in a subdirectory of a specified directory). If this is the case, the shortcut works.

Back to the top

Steps to Reproduce the Behavior

1.Use HTML Help Workshop to create a test HTML Help project that contains one topic.
2.Add a shortcut to the topic that runs Notepad.exe. To do this, follow these steps:
a. Click Tags, and then click HTML Help Control.
b. In the Specify The Command dropdown list, click ShortCut, and then click Next.
c. In the text box labeled Text, type Notepad, and then click Next.
d. In the text box labeled Program, type notepad.exe, click Next two times, and then click Finish.
3.Compile the project into a .chm file.
4.Create a network share on a different computer, and then copy the .chm file to that computer.
5.On the first computer, start Internet Explorer.
6.In the address bar, type the name of the shared path. For example:
\\myshare\mydir\myhelp.chm
7.When the topic appears, click Notepad.

Back to the top

REFERENCES

For more information about group policies, visit the following Microsoft Web site:
Windows 2000 Group Policy (http://www.microsoft.com/windows2000/techinfo/howitworks/management/grouppolwp.asp)
For more information about HTML Help, see the following Microsoft Developer Network article:
HTML Help Start Page (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconHH1Start.asp?frame=true)

Back to the top


APPLIES TO
Microsoft Windows NT 4.0 Service Pack 6
the operating system: Microsoft Windows XP
Microsoft Windows 2000 Standard Edition
Microsoft Windows 98 Second Edition
Microsoft Windows Millennium Edition
Microsoft Windows Server 2003, Standard Edition (32-bit x86)

Back to the top

Keywords: 
kbprb kbpending kbhtmlhelp KB323180

Back to the top

Article Translations

 

Other Support Options

  • Contact Microsoft
    Phone Numbers, Support Options and Pricing, Online Help, and more.
  • Customer Service
    For non-technical assistance with product purchases, subscriptions, online services, events, training courses, corporate sales, piracy issues, and more.
  • Newsgroups
    Pose a question to other users. Discussion groups and Forums about specific Microsoft products, technologies, and services.