Microsoft Knowledge Base Email Alertz

HTML Help supports a command named

Search KbAlertz

Advanced Search

Receive Microsoft Knowledge Base articles by E-Mail?

Every night we scan the Microsoft Knowledge Base. If technologies you're interested in are updated, we'll send you an e-mail. You only get one e-mail a day, and only when new articles are added.

Click here to create a
FREE account
Already have an account?
[Click here to Login]











Microsoft Knowledge Base Article

This article contents is Microsoft Copyrighted material.
©2005-©2007 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks

Article ID: 323180 - Last Review: February 1, 2007 - Revision: 3.5

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

System TipThis article applies to a different version of Windows than the one you are using. Content in this article may not be relevant to you. Visit the Windows Vista Solution Center
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.

STATUS

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

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.
    1. 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.
    2. 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.

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:
    1. Click Tags, and then click HTML Help Control.
    2. In the Specify The Command dropdown list, click ShortCut, and then click Next.
    3. In the text box labeled Text, type Notepad, and then click Next.
    4. 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.

REFERENCES

For more information about group policies, visit the following Microsoft Web site:
Windows 2000 Group Policy (http://download.microsoft.com/download/5/2/f/52f3dbd6-2864-4d97-8792-276544ad6426/grouppolwp.doc)
For more information about HTML Help, see the following Microsoft Developer Network article:
HTML Help Start Page (http://msdn.microsoft.com/en-us/library/ms670169.aspx)

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

Community Feedback System

Very often, it takes hours to solve a problem. Very often, you've looked high and low, and have tried a lot of solutions. When you finally found it, chances are, it was because someone else helped you. Here's your chance to give back. Use our community feedback tool to let others know what worked for you and what didn't.

Please also understand that the community feedback system is not warranted to be correct, it's simply a system that we've built to let people try and help each other. If something in a feedback response doesn't make sense to you, or you're not comfortable making changes that the feedback talks about (like registry edits), please consult a professional.

Thank you for using kbAlertz.com Feedback System.

-- Scott Cate