INTRODUCTION
An update that extends the mechanism for displaying snap-in context Help topics is available for the Microsoft Management Console (MMC) in Windows Server 2008. This update lets snap-ins display Help topics in custom ways instead of in a standard MMC Help window. For example, this update lets a snap-in open a Web Help topic instead of a compiled HTML (CHM) Help topic.
After this update is applied, developers can program the MMC to send Help events to the snap-in instead of opening a CHM Help topic. Therefore, when users click the Help menu or press F1, an event is sent to the snap-in to display.
More Information
Pre-update behavior
The section describes Help event behavior before the update is applied. The snap-in defines the HelpTopic path, and the MMC caches this information. When the MMC displays a context Help topic, the MMC opens a standard MMC Help window without calling the snap-in. If the snap-in has defined the Help topic for the selected item, the MMC Help window shows that topic. If no Help topic is defined, the MMC Help window shows the default MMC 3.0 Help topic.
A snap-in can set the HelpTopic property in the following three locations:
-
The ScopeNode class
-
The PropertyPage class
-
The SelectionData property that is used by the View class
Post-update behavior
After the update is applied, developers have two mechanisms for displaying a Help topic including the one that exists before the update is applied.
Callback
A snap-in sets the UseCustomHelp property of the SnapInSettingsAttribute class to True, and then the snap-in registers a snap-in level callback. The callback is triggered by the MMC when the snap-in requests that MMC display a Help topic. When the UseCustomHelp property is set to True, the pre-update mechanism is ignored. The MMC does not display the standard MMC Help window.
HelpTopic property
This mechanism is the one that existed before the update was applied. This mechanism works only if the snap-in does not set the UseCustomHelp property to True.
To display the Help topic in a customized way, the MMC must follow these steps:
-
It must set the UseCustomHelp property of the SnapInSettingsAttribute class to True.
-
It must register a callback with MMC.
When the MMC receives a request to display a Help topic, the MMC first checks the snap-in registration information to see whether the snap-in has set the UseCustomHelp property. If the snap-in has not set the UseCustomHelp property to True, the MMC starts a standard MMC Help window. If the snap-in has set the UseCustomHelp property to True, the MMC does not start a standard MMC Help window. Instead, the MMC finds and triggers the callback that is registered by the snap-in. In this case, the snap-in is completely responsible for displaying the Help topic. If the snap-in wants to use the callback mechanism to show a standard MMC Help window, it can call the SnapInBase.ShowHelpTopic function.
New APIs that are exposed to snap-ins
UseCustomHelp is a new property that is added to the SnapInSettingsAttribute class. By default, this property is set to False. To customize the MMC Help display, a snap-in should set this property to True.
Microsoft.ManagementConsole.SnapInCallbackService is a new class that lets a snap-in register a snap-in level callback. The callback will handle the Help topic display.
SnapInHelpTopicCallback is a type of delegate that a snap-in should create and register with the MMC. This delegate takes an object as a parameter to specify the item on which the Help topic is requested. This parameter can be one of the following types of objects that have the HelpTopic property:
-
ScopeNode
-
SelectionData
-
PropertyPage
This parameter can also be Null. A Null parameter indicates that the MMC is unable to find an object.
RegisterSnapInHelpTopicHandler is a function that a snap-in calls to register a callback. This function takes the following two parameters:
-
Snap-in instance
-
Callback function
Neither of the parameters can be Null. Otherwise, the MMC throws an ArgumentNullException exception.
Update information
The following files are available for download from the Microsoft Download Center:
Update for Windows Server 2008 x64 Edition
Update for Windows Server 2008 for Itanium-based Systems
Update for Windows Server 2008
Update for Windows Vista
Update for Windows Vista for x64-based Systems
For more information about how to download Microsoft support files, click the following article number to view the article in the Microsoft Knowledge Base:
119591 How to obtain Microsoft support files from online services
Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help prevent any unauthorized changes to the file.
A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.
If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.
Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site:
http://support.microsoft.com/contactus/?ws=supportNote The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.
Prerequisites
No prerequisites are required.
Restart requirement
You do not have to restart the computer after you apply this update.
Update replacement information
This update does not replace any other updates.
File information
The English version of this update has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.
Windows Server 2008, 32-bit editions
|
File name |
File version |
File size |
Date |
Time |
Platform |
|---|---|---|---|---|---|
|
Microsoft.managementconsole.dll |
6.0.6001.22169 |
188,416 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcex.dll |
6.0.6001.22169 |
417,792 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcfxcommon.dll |
6.0.6001.22169 |
110,592 |
30-Apr-2008 |
05:31 |
x86 |
Windows Server 2008, Itanium-based editions
|
File name |
File version |
File size |
Date |
Time |
Platform |
|---|---|---|---|---|---|
|
Microsoft.managementconsole.dll |
6.0.6001.22169 |
188,416 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcfxcommon.dll |
6.0.6001.22169 |
110,592 |
30-Apr-2008 |
05:31 |
x86 |
Windows Server 2008, 64-bit editions
|
File name |
File version |
File size |
Date |
Time |
Platform |
|---|---|---|---|---|---|
|
Microsoft.managementconsole.dll |
6.0.6001.22169 |
188,416 |
30-Apr-2008 |
05:31 |
x86 |
|
Mmcfxcommon.dll |
6.0.6001.22169 |
110,592 |
30-Apr-2008 |
05:31 |
x86 |
More Information
Context Help topic
A context Help topic is a type of Help topic that is associated with a snap-in item, such as a Scope Node. To start context Help topics, users can press F1, or they can click Help on the Actions menu, on a shortcut menu, or in the Actions pane.
For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:
824684 Description of the standard terminology that is used to describe Microsoft software updates
