Conception d’extensions de classe d’assistance NDF

  • Article

Cette rubrique est destinée à fournir des conseils génériques tout au long du processus de développement d’extension de classe d’assistance. Les conseils de cette rubrique s’appliquent à toutes les extensions de classe d’assistance. Pour obtenir des conseils plus spécifiques, consultez Classe d’assistance extensible de la plateforme de filtrage Windows et Classes d’assistance extensibles diagnostics sans fil 802.11.

Extension des fonctionnalités NDF

Windows Vista et les versions ultérieures sont fournis avec diverses classes d’assistance déjà implémentées qui peuvent diagnostiquer et réparer un large éventail de problèmes. Toutefois, les développeurs tiers peuvent parfois souhaiter étendre ces classes d’assistance pour diagnostiquer et résoudre les problèmes spécifiques à leurs produits et implémentations particuliers.

Les classes d’assistance Microsoft NDF suivantes sont extensibles.

Implémentation d’une extension de classe d’assistance

Microsoft fournit deux interfaces qui peuvent être utilisées pour développer des extensions de classe d’assistance NDF.

L’interface INetDiagHelperInfo est appelée par NDF pour vérifier qu’elle dispose de toutes les informations requises et qu’elle a choisi la classe d’assistance appropriée. Il effectue cette opération via la méthode GetAttributeInfo .

L’interface INetDiagHelper est appelée par NDF pour la plupart des activités qui se produisent pendant la procédure de diagnostic. Plusieurs de ses méthodes sont requises, mais d’autres sont facultatives pour des utilisations spécifiques.

Les méthodes requises incluent Initialize et GetDiagnosticsInfo. NDF appelle Initialize pour envoyer des paramètres de clé à l’extension de classe d’assistance afin d’initialiser son état instance. GetDiagnosticsInfo fournit une estimation de la durée du diagnostic et indique s’il nécessite l’emprunt d’identité du contexte utilisateur d’origine.

Une autre méthode, LowHealth, est appelée pour effectuer un diagnostic sur le composant réseau correspondant à la classe d’assistance. Cancel est appelé lorsque NDF détermine qu’un diagnostic ou une réparation en cours doit être arrêté. Le nettoyage permet à NDF de libérer les ressources NDF que l’extension de classe d’assistance a utilisées depuis l’appel à Initialize .

Pour plus d’informations sur les méthodes supplémentaires, consultez INetDiagHelper.

Les extensions de classe d’assistance NDF sont utilisées pour diagnostiquer et résoudre les problèmes de connectivité associés à une application ou à un composant spécifique. Ils valident également la réussite ou l’échec d’une tentative de résolution.

Les développeurs qui envisagent l’implémentation d’une extension de classe d’assistance doivent effectuer les tâches suivantes.

  • Identifiez les scénarios utilisateur dans lesquels les actions de diagnostic et de réparation sont utiles.
  • Fournir des solutions aux problèmes de connectivité fréquemment rencontrés.
  • Si une extension de classe d’assistance est requise, définissez un modèle d’intégrité du composant utilisé pour représenter l’état d’intégrité du composant dans NDF.

Identifier les scénarios utilisateur

Le test et l’utilisation d’une application ont peut-être déjà fourni des modèles discernables qu’une extension de classe d’assistance peut être en mesure de diagnostiquer et éventuellement de réparer. Les développeurs d’applications peuvent utiliser ces données pour déterminer les problèmes de connectivité les plus importants à résoudre et pour identifier les scénarios utilisateur dans lesquels des problèmes de connectivité sont susceptibles de se produire.

La détermination de la cause racine de chaque problème est essentielle dans cette partie du processus. Cela peut nécessiter des recherches approfondies, mais aidera à créer des logiciels beaucoup plus faciles à utiliser pour les utilisateurs et les administrateurs. Si aucune cause racine n’est identifiée, il devient difficile, voire impossible, de proposer une résolution de problème à l’aide de l’extension de classe d’assistance.

Fournir des résolutions

Une fois qu’une équipe de développement a identifié les causes racines des problèmes associés à son logiciel, l’étape suivante consiste à identifier les actions de résolution appropriées pour aider l’utilisateur à résoudre le problème aussi efficacement que possible.

Toutes les résolutions ne nécessitent pas la création d’une extension de classe d’assistance ou d’une action automatisée. Dans certains cas, l’équipe peut déterminer que la meilleure approche pour résoudre une cause racine consiste à corriger ou à mettre à jour le composant, à fournir du contenu d’aide supplémentaire pour le composant ou à développer d’autres stratégies qui fournissent de meilleures solutions à long terme.

Pour les problèmes dans lesquels une action automatisée est idéale, la création d’une extension de classe d’assistance NDF est souvent une excellente solution.

Les extensions de classe d’assistance retournent des informations sur les causes racines et les informations de réparation aux utilisateurs via NDF. Les chaînes utilisées pour décrire les causes racines et les informations de réparation doivent être simples et faciles à comprendre pour un utilisateur non technique. Pour plus d’informations sur ces chaînes, consultez Instructions relatives à l’interface utilisateur pour les extensions de classe NDF Helper.

Définir un modèle d’intégrité de composant

Les développeurs de logiciels doivent définir des niveaux d'« intégrité » associés à la facilité de gestion des problèmes de mise en réseau. Un modèle d’intégrité utilisé pour développer des classes d’assistance ne définit que deux niveaux d’intégrité : sain et non sain. Ces niveaux peuvent également être appliqués aux extensions de classe d’assistance NDF.

Un composant sain indique l’absence de problèmes. Un composant peut être considéré comme non sain en raison de ses propres problèmes ou en raison de problèmes qui se produisent dans d’autres composants dont il dépend.

Terme Description
LowHealth
 Cet état indique un niveau inacceptable d’échecs de ce composant et que le composant est le problème.
LowHealth Below
 Cet état indique un niveau inacceptable de défaillances d’un composant d’ordinateur local dont dépend ce composant.

Lorsque le diagnostic est effectué à l’aide de NDF, une série de questions est posée à l’extension de classe d’assistance pour déterminer son état d’intégrité. Si l’extension répond qu’elle n’est pas saine, NDF pose des questions de clarification, en essayant de diagnostiquer le problème, son emplacement et l’emplacement suivant. Chaque classe d’assistance doit être en mesure de répondre à la question de l’intégrité faible afin de mieux diriger les activités de diagnostic appropriées.

Classe d’application auxiliaire extensible de la plateforme de filtrage Windows

802.11 Classes d’assistance extensibles diagnostics sans fil