Symptoms
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.
Resolution
Pre-update behaviorThe section describes Help eventbehavior 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 classThe PropertyPage classThe SelectionData property that is used by the View class
Post-update behaviorAfter the update is applied, developers have two mechanisms for displaying a Help topic including theone that exists before the update is applied.CallbackA 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 propertyThis 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-insUseCustomHelp 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:ScopeNodeSelectionDataPropertyPageThis 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 instanceCallback functionNeither of the parameters can be Null. Otherwise, the MMC throws an ArgumentNullException exception.
Update informationThe following files are available for download from the MicrosoftDownload Center:
Update for Windows Server 2008 x64 Edition
Collapse this imageExpand this image
Download the KB951725 package now.(http://www.microsoft.com/downloads/details.aspx?FamilyId=1A267131-0362-468C-AB62-28E8EB4ECAAD)
Update for Windows Server 2008 for Itanium-based Systems
Collapse this imageExpand this image
Download the KB951725 package now.(http://www.microsoft.com/downloads/details.aspx?FamilyId=2EC05D52-E648-4C5F-A362-1EF74B887400)
Update for Windows Server 2008
Collapse this imageExpand this image
Download the KB951725 package now.(http://www.microsoft.com/downloads/details.aspx?FamilyId=E5633FDA-CCE2-4B52-81BD-60469336CE58)
Update for Windows Vista
Collapse this imageExpand this image
Download the KB951725 package now.(http://www.microsoft.com/downloads/details.aspx?FamilyId=6D6FDC3A-18B3-4F30-9CC4-1805E2B83CB4)
Update for Windows Vista for x64-based Systems
Collapse this imageExpand this image
Download the KB951725 package now.(http://www.microsoft.com/downloads/details.aspx?FamilyId=3ADC541E-F3F8-4A55-AF21-A3DE5219072C)
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?(http://support.microsoft.com/kb/119591/) How to obtain Microsoft support files from online servicesMicrosoft 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 tocreate a separate service request, visit the following Microsoft Web site:
http://support.microsoft.com/contactus/?ws=support(http://support.microsoft.com/contactus/?ws=support)Note 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.PrerequisitesNo prerequisites are required.Restart requirementYou do not have to restart the computer after you apply this update.Update replacement informationThis update does not replace any other updates.File informationThe 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
Collapse this tableExpand this table
File nameFile versionFile sizeDateTimePlatformMicrosoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31×86Mmcex.dll6.0.6001.22169417,79230-Apr-200805:31×86Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31×86Windows Server 2008, Itanium-based editions
Collapse this tableExpand this table
File nameFile versionFile sizeDateTimePlatformMicrosoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31×86Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31×86Windows Server 2008, 64-bit editions
Collapse this tableExpand this table
File nameFile versionFile sizeDateTimePlatformMicrosoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31×86Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31×86