Det finns en uppdatering som utökar mekanismen för att visa hjälpavsnitt för snapin-modulen kontext för MMC i Windows Server 2008

Gäller för: Windows Server 2008 StandardWindows Server 2008 EnterpriseWindows Server 2008 Datacenter

Introduktion


En uppdatering som utökar mekanismen för att visa hjälpavsnitt för snapin-modulen kontext är tillgängligt för Microsoft Management Console (MMC) i Windows Server 2008. Den här uppdateringen kan hjälpavsnitt för snapin-moduler Visa anpassade sätt i stället för i ett vanligt fönster i MMC-hjälpen. Den här uppdateringen kan till exempel en snapin-modul som öppnar ett hjälpavsnitt i stället för en hjälpfil i HTML (CHM).

När uppdateringen har installerats, kan utvecklare programmera MMC för att skicka händelser för hjälp till snapin-modulen i stället för att öppna en CHM-hjälpavsnittet. Därför, när användare klickar på Hjälp-menyn eller trycka på F1, en händelse skickas till snapin-modulen ska visas.

Mer Information


Före uppdateringen

Avsnittet beskriver hjälp händelse beteende innan uppdateringen. Snapin-modulen definierar HelpTopic sökvägen och MMC cachelagrar denna information. När MMC visar ett hjälpavsnitt för kontext, öppnar ett vanligt hjälpen för MMC-fönster utan att snapin-modulen MMC. Snapin-modulen har definierats i hjälpavsnittet för den valda artikeln i hjälpen för MMC-fönstret visas avsnittet. Om inget hjälpavsnitt definieras i hjälpen för MMC-fönstret visas avsnittet standard hjälpen för MMC 3.0.

Snapin-modulen kan ange egenskapen HelpTopic på följande tre platser:
  • ScopeNode -klass
  • PropertyPage -klass
  • Egenskapen SelectionData används av Visa -klass

Efter uppdateringen

När uppdateringen har installerats har utvecklare två mekanismer för att visa ett hjälpavsnitt, inklusive det som finns innan uppdateringen.

Motringning

Snapin-modulen ställer du in egenskapen UseCustomHelp i klassen SnapInSettingsAttribute till True och registrerar sedan nivå återanrop snapin-modulen i snapin-modulen. Återanropet utlöses av MMC när du begär att ett hjälpavsnitt visas för MMC snapin-modulen. När egenskapen UseCustomHelp har angetts till True ignoreras mekanismen före uppdateringen. Standard hjälpen för MMC-fönstret visas inte i MMC.

HelpTopic egenskap

Denna mekanism är det som fanns innan uppdateringen installerades. Denna mekanism fungerar bara om snapin-modulen inte anger egenskapen UseCustomHelp till True.

Om du vill visa hjälpavsnitt på ett anpassat sätt så MMC här:
  1. Det måste ange egenskapen UseCustomHelp i klassen SnapInSettingsAttribute till True.
  2. Det måste registrera ett återanrop med MMC.
När MMC tar emot en begäran om du vill visa ett hjälpavsnitt, kontrollerar först MMC-snapin-modulen registreringsinformation om snapin-modulen har angett egenskapen UseCustomHelp . Om snapin-modulen inte har egenskapen UseCustomHelp till True, startar ett vanligt fönster i MMC-hjälpen i MMC. Om snapin-modulen har egenskapen UseCustomHelp till True, startar inte ett vanligt fönster i MMC-hjälpen i MMC. I stället hittar MMC och utlöser motringning som registrerats av snapin-modulen. I det här fallet är snapin-modulen helt ansvarig för att visa hjälpavsnittet. Om snapin-modulen du vill använda motringning mekanism för att visa ett vanligt hjälpen för MMC-fönster, kan den anropa funktionen SnapInBase.ShowHelpTopic .

Nya API: er som är utsatta för snapin-moduler

UseCustomHelp är en ny egenskap som läggs till i klassen SnapInSettingsAttribute . Som standard anges den här egenskapen till False. Om du vill anpassa hur hjälpen för MMC bör snapin-modulen ange den här egenskapen till True.

Microsoft.ManagementConsole.SnapInCallbackService är en ny klass som gör att en snapin-modul som registrerar nivå återanrop snapin-modulen. I hjälpavsnittet Visa hanterar återanropet.

SnapInHelpTopicCallback är en typ av ombud som en snapin-modul ska skapa och registrera i MMC. Det här ombudet tar ett objekt som en parameter för att ange den artikel som begärs i hjälpavsnittet. Den här parametern kan vara en av följande typer av objekt som har egenskapen HelpTopic :
  • ScopeNode
  • SelectionData
  • PropertyPage
Den här parametern kan också vara Null. En Null-parameter anger att MMC är det gick inte att hitta ett objekt.

RegisterSnapInHelpTopicHandler är en funktion som anropar för att registrera en callback för en snapin-modul. Den här funktionen har följande två parametrar:
  • Snapin-modulen instans
  • Callback-funktion
Ingen av parametrarna som kan vara Null. I annat fall genereras ett ArgumentNullException undantag i MMC.

Information om uppdateringen

Följande filer kan hämtas från Microsoft Download Center:

Uppdatering för Windows Server 2008 x64
Download Hämta paketet KB951725 nu.

Uppdatering för Windows Server 2008 för Itanium-baserade system
Download Hämta paketet KB951725 nu.

Uppdatering för Windows Server 2008
Download Hämta paketet KB951725 nu.

Uppdatering för Windows Vista
Download Hämta paketet KB951725 nu.

Uppdatering för Windows Vista för x64-baserade system
Download Hämta paketet KB951725 nu.

För mer information om hur du hämtar supportfiler från Microsoft klickar du på följande artikelnummer och läser artikeln i Microsoft Knowledge Base:
Microsoft har genomsökt denna fil efter virus. Microsoft använde det mest aktuella antivirusprogram som var tillgängligt när filen lades upp. Filen är sparad på servrar med utökad säkerhet som hjälper till att förhindra otillåtna ändringar av den.


En snabbkorrigering är tillgänglig från Microsoft. Den här snabbkorrigeringen är emellertid avsedd att åtgärda det problem som beskrivs i denna artikel. Använd bara den här snabbkorrigeringen för system med just detta problem. Snabbkorrigeringen kan komma att testas igen. Om du inte störs alltför mycket av detta problem rekommenderar vi att du väntar på nästa programuppdatering som innehåller den här snabbkorrigeringen.

Om snabbkorrigeringen är tillgänglig för hämtning finns ett avsnitt för "Snabbkorrigeringen är tillgänglig" överst i den här Knowledge Base-artikeln. Om den sektionen saknas, kontakta Microsofts support för att få tag på hotfixen.

Obs! Om det uppstår ytterligare problem eller krävs felsökning, kan du behöva skapa en serviceförfrågan. De vanliga supportkostnaderna gäller för övriga supportfrågor och problem som inte uppfyller kraven för den här snabbkorrigeringen. En fullständig lista över telefonnummer för Microsofts kundtjänst och Support eller skapa en serviceförfrågan finns på följande Microsoft-webbplats:Obs! "Snabbkorrigeringen tillgänglig"-formuläret visar de språk som snabbkorrigeringen är tillgänglig. Om ditt språk inte visas beror det på att ingen snabbkorrigering är tillgänglig för språket.

Förutsättningar

Det finns inga förutsättningar.

Krav på omstart

Du behöver inte starta om datorn när du har installerat den här uppdateringen.

Information om vad uppdateringen ersätter

Den här uppdateringen ersätter inte några andra uppdateringar.

Filinformation

Den engelska versionen av den här uppdateringen har de filattribut (eller senare filattribut) som visas i följande tabell. Datum och tider för dessa filer anges i UTC-tid (UTC). När du visar filinformationen konverteras den till lokal tid. Använd fliken tidszon i datum och tid på Kontrollpanelen om du vill se skillnaden mellan UTC-tid och lokal tid.
Windows Server 2008, 32-bitarsversioner
FilnamnFilversionStorlekDatumTidPlattform
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcex.dll6.0.6001.22169417,79230-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31x86
Windows Server 2008, Itanium-baserade utgåvor
FilnamnFilversionStorlekDatumTidPlattform
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31x86
Windows Server 2008, 64-bitarsversioner
FilnamnFilversionStorlekDatumTidPlattform
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31x86

Mer Information


Hjälpavsnitt för kontext

Ett hjälpavsnitt i sammanhanget är en typ av hjälpavsnittet som är associerat med ett snapin-objekt, till exempel en scopenod. Användare kan trycka på F1 om du vill starta sammanhang hjälpavsnitt eller de kan klicka på Hjälpåtgärder -menyn på en snabbmeny eller i åtgärdsfönstret.

För mer information om terminologin för programuppdateringar klickar du på följande artikelnummer och läser artikeln i Microsoft Knowledge Base:
824684 beskrivning av standardterminologin som används för att beskriva Microsoft-programuppdateringar