Une mise à jour qui étend le mécanisme d’affichage des rubriques d’aide de contexte du composant logiciel enfichable est disponible pour la console MMC dans Windows Server 2008

S’applique à : Windows Server 2008 StandardWindows Server 2008 EnterpriseWindows Server 2008 Datacenter

INTRODUCTION


Une mise à jour qui étend le mécanisme d’affichage des rubriques d’aide de contexte du composant logiciel enfichable est disponible pour Microsoft Management Console (MMC) dans Windows Server 2008. Cette mise à jour permet de rubriques d’aide affichage des composants de manière personnalisée et non dans une fenêtre d’aide de la console MMC standard. Par exemple, cette mise à jour permet à un composant logiciel enfichable ouvrir une rubrique d’aide Web au lieu d’une rubrique d’aide compilé HTML (CHM).

Après application de cette mise à jour, les développeurs peuvent programmer la console MMC pour envoyer des événements de l’aide pour le composant logiciel enfichable au lieu d’ouvrir une rubrique d’aide de CHM. Par conséquent, lorsque les utilisateurs, cliquez sur le menu Aide ou appuyez sur F1, un événement est envoyé dans le composant logiciel enfichable à afficher.

Plus d'informations


Comportement de mise à jour préalable

La section décrit le comportement de l’événement aide avant l’application de la mise à jour. Le composant logiciel enfichable définit le chemin d’accès HelpTopic, et la console MMC met en cache ces informations. Lorsque la console MMC affiche une rubrique d’aide contextuelle, MMC ouvre une fenêtre d’aide de la console MMC standard sans appeler le composant logiciel enfichable. Si le composant logiciel enfichable a défini la rubrique d’aide pour l’élément sélectionné, la fenêtre d’aide de la console MMC affiche cette rubrique. Si aucune rubrique d’aide n’est défini, la fenêtre d’aide de la console MMC affiche la rubrique d’aide de MMC 3.0 par défaut.

Un composant logiciel enfichable peut définir la propriété HelpTopic dans les trois emplacements suivants :
  • La classe ScopeNode
  • La classe PropertyPage
  • La propriété SelectionData qui est utilisée par la classe d’affichage

Comportement de mise à jour

Une fois la mise à jour est appliquée, les développeurs ont deux mécanismes pour l’affichage d’une rubrique d’aide, notamment celle qui existe avant la mise à jour est appliquée.

Rappel

Un composant logiciel enfichable définit la propriété UseCustomHelp de la classe SnapInSettingsAttribute sur True, et le composant logiciel enfichable inscrit un rappel au niveau du composant logiciel enfichable. Le rappel est déclenché par la console MMC lors de l’utilisation du composant logiciel enfichable demande que MMC affiche une rubrique d’aide. Lorsque la propriété UseCustomHelp est définie sur True, le mécanisme de mise à jour préalable est ignoré. La console MMC n’affiche pas la fenêtre d’aide de la console MMC standard.

Propriété de HelpTopic

Ce mécanisme est celui qui existait avant la mise à jour a été appliquée. Ce mécanisme fonctionne uniquement si le composant logiciel enfichable ne définit pas la propriété UseCustomHelp sur True.

Pour afficher la rubrique d’aide de façon personnalisée, la console MMC doit suivre ces étapes :
  1. Il doit définir la propriété UseCustomHelp de la classe SnapInSettingsAttribute sur True.
  2. Elle doit inscrire un rappel avec la console MMC.
Lorsque la console MMC reçoit une demande pour afficher une rubrique d’aide, la console MMC vérifie d’abord les informations de l’enregistrement du composant logiciel enfichable pour voir si le composant logiciel enfichable l’a défini la propriété UseCustomHelp . Si le composant logiciel enfichable n'a pas défini la propriété UseCustomHelp sur True, la console MMC démarre une fenêtre aide MMC standard. Si le composant logiciel enfichable a défini la propriété UseCustomHelp sur True, la console MMC ne démarre pas une fenêtre aide MMC standard. Au lieu de cela, la console MMC recherche et déclenche le rappel enregistré par le composant logiciel enfichable. Dans ce cas, le composant logiciel enfichable est complètement chargé d’afficher la rubrique d’aide. Si le composant logiciel enfichable souhaite utiliser le mécanisme de rappel pour afficher une fenêtre d’aide de la console MMC standard, il peut appeler la fonction SnapInBase.ShowHelpTopic .

Nouvelles API qui est exposés à des composants enfichables

UseCustomHelp est une propriété qui est ajoutée à la classe SnapInSettingsAttribute . Par défaut, cette propriété a la valeur False. Pour personnaliser l’affichage de l’aide de MMC, un composant logiciel enfichable doit définir cette propriété sur True.

Microsoft.ManagementConsole.SnapInCallbackService est une classe qui permet à un composant logiciel enfichable inscrire un rappel de niveau composant. Le rappel gérera l’affichage de la rubrique d’aide.

SnapInHelpTopicCallback est un type de délégué à un composant logiciel enfichable doit créer et d’enregistrer avec la console MMC. Ce délégué prend un objet comme un paramètre pour spécifier l’élément sur lequel la rubrique d’aide est demandée. Ce paramètre peut être un des types d’objets qui ont la propriété HelpTopic suivants :
  • ScopeNode
  • SelectionData
  • PropertyPage
Ce paramètre peut également être Null. Un paramètre Null indique que la console MMC ne peut pas trouver un objet.

RegisterSnapInHelpTopicHandler est une fonction qui a un composant logiciel enfichable appelle pour inscrire un rappel. Cette fonction accepte les deux paramètres suivants :
  • Instance du composant logiciel enfichable
  • Fonction de rappel
Aucun des paramètres peut être Null. Dans le cas contraire, la console MMC lève une exception ArgumentNullException.

Informations de mise à jour

Les fichiers suivants sont disponibles pour téléchargement à partir du Microsoft Download Center :

Mise à jour pour Windows Server 2008 x64 Edition
Download Télécharger le package KB951725 maintenant.

Mise à jour pour Windows Server 2008 pour systèmes Itanium
Download Télécharger le package KB951725 maintenant.

Mise à jour pour Windows Server 2008
Download Télécharger le package KB951725 maintenant.

Mise à jour pour Windows Vista
Download Télécharger le package KB951725 maintenant.

Mise à jour pour Windows Vista version x64
Download Télécharger le package KB951725 maintenant.

Pour plus d'informations sur la façon de télécharger des fichiers de support technique Microsoft, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
Microsoft a vérifié que ce fichier ne comportait pas de virus. Microsoft a utilisé les logiciels de détection de virus les plus récents disponibles à la date à laquelle le fichier a été validé. Le fichier est stocké sur des serveurs sécurisés, ce qui empêche toute modification non autorisée du fichier.


Un correctif pris en charge est disponible auprès de Microsoft. Toutefois, ce correctif vise à corriger uniquement le problème décrit dans cet article. Appliquez ce correctif uniquement aux systèmes rencontrant ce problème spécifique. Ce correctif va peut-être subir des tests supplémentaires. Par conséquent, si vous n'êtes pas sérieusement concerné par ce problème, nous vous recommandons d'attendre la prochaine mise à jour logicielle qui contiendra ce correctif.

Si le correctif est disponible pour le téléchargement, il existe une section « Téléchargement de correctif logiciel disponible » au début de cet article de la Base de connaissances. Si cette section n'apparaît pas, contactez le Service clientèle et Support de Microsoft pour obtenir le correctif.

Remarque Si des problèmes supplémentaires se produisent ou si des procédures de dépannage sont nécessaires, vous devrez peut-être formuler une demande de service distincte. Les coûts habituels du support technique s'appliqueront aux questions et problèmes qui ne relèvent pas de ce correctif logiciel. Pour une liste complète des numéros de téléphone service clientèle de Microsoft ou pour créer une demande de service distincte, visitez le site Web de Microsoft à l’adresse suivante :Remarque Le formulaire « Téléchargement de correctif logiciel disponible » affiche les langues pour lesquelles le correctif est disponible. Si vous ne voyez pas votre langue, c'est parce qu'il n'y a pas de correctif disponible pour cette langue.

Conditions préalables

Aucunes conditions préalables ne sont requises.

Nécessite un redémarrage

Vous n'êtes pas obligé de redémarrer l'ordinateur après avoir appliqué cette mise à jour.

Mettre à jour les informations sur le remplacement

Cette mise à jour ne remplace pas d'autres mises à jour.

Informations sur les fichiers

La version anglaise de cette mise à jour a les attributs de fichier (ou ultérieure) répertoriés dans le tableau suivant. Les dates et heures de ces fichiers sont répertoriées en temps universel coordonné (UTC). Lorsque vous affichez les informations de fichier, elles sont converties en heure locale. Pour trouver la différence entre l’UTC et l’heure locale, utilisez l’onglet fuseau horaire dans l’élément de Date et heure dans le panneau de configuration.
Windows Server 2008, éditions 32 bits
Nom de fichierVersion de fichierTaille du fichierDateHeurePlateforme
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, versions Itanium
Nom de fichierVersion de fichierTaille du fichierDateHeurePlateforme
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31x86
Windows Server 2008, Édition 64 bits
Nom de fichierVersion de fichierTaille du fichierDateHeurePlateforme
Microsoft.managementconsole.dll6.0.6001.22169188,41630-Apr-200805:31x86
Mmcfxcommon.dll6.0.6001.22169110,59230-Apr-200805:31x86

Plus d'informations


Rubrique d’aide contextuelle

Une rubrique d’aide contextuelle est un type de rubrique d’aide qui est associée à un élément logiciel enfichable, tel qu’un nœud d’étendue. Pour lancer les rubriques d’aide de contexte, les utilisateurs peuvent appuyer sur F1, ou ils peuvent cliquer sur aide dans le menu Actions , sur un menu contextuel ou dans le volet Actions.

Pour plus d'informations sur la terminologie de mise à jour logicielle, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
Description 824684 terminologie standard utilisée pour décrire les mises à jour logicielles de Microsoft