Progettazione delle estensioni della classe helper NDF
Questo argomento è destinato a fornire indicazioni generice tramite il processo di sviluppo dell'estensione della classe helper. Le indicazioni contenute in questo argomento si applicano a tutte le estensioni della classe helper. Per indicazioni più specifiche, vedere Classi helper estendibili della piattaforma di filtro di Windows e classe 802.11 Diagnostica wireless estendibile.
Estensione della funzionalità NDF
Windows Vista e versioni successive vengono fornite con diverse classi helper già implementate che possono diagnosticare e riparare un'ampia gamma di problemi. Tuttavia, a volte, gli sviluppatori di terze parti possono voler estendere queste classi helper per diagnosticare e risolvere i problemi specifici dei propri prodotti e implementazioni.
Le classi helper microsoft NDF seguenti sono estendibili.
Implementazione di un'estensione della classe Helper
Microsoft offre due interfacce che possono essere usate per sviluppare estensioni della classe helper NDF.
L'interfaccia INetDiagHelperInfo viene chiamata da NDF per verificare che disponga di tutte le informazioni necessarie e che abbia scelto la classe helper corretta. Questa operazione viene eseguita tramite il metodo GetAttributeInfo .
L'interfaccia INetDiagHelper viene chiamata da NDF per la maggior parte delle attività che si verificano durante la procedura di diagnostica. Sono necessari diversi metodi, ma altri sono facoltativi per usi specifici.
I metodi necessari includono Initialize e GetDiagnosticsInfo. NDF chiama Initialize per inviare parametri chiave all'estensione della classe helper per inizializzare lo stato dell'istanza. GetDiagnosticsInfo fornisce una stima della durata della diagnosi e se richiede la rappresentazione del contesto utente originale.
Un altro metodo, LowHealth, viene chiamato per eseguire la diagnosi nel componente di rete corrispondente alla classe helper. Annulla viene chiamato quando NDF determina una diagnosi o una riparazione in corso deve essere arrestata. La pulizia consente a NDF di rilasciare le risorse NDF usate dall'estensione della classe helper dal momento che è stata eseguita la chiamata a Initialize .
Per informazioni sui metodi aggiuntivi, vedere INetDiagHelper.
Le estensioni della classe helper NDF vengono usate per diagnosticare e risolvere i problemi di connettività associati a un'applicazione o a un componente specifico. Convalidano anche l'esito positivo o negativo di un tentativo di risoluzione.
Gli sviluppatori che considerano l'implementazione di un'estensione della classe helper devono eseguire le attività seguenti.
- Identificare gli scenari utente in cui sono utili le azioni di diagnostica e ripristino.
- Fornire soluzioni per i problemi di connettività rilevati di frequente.
- Se è necessaria un'estensione della classe helper, definire un modello di integrità dei componenti usato per rappresentare lo stato di integrità del componente in NDF.
Identificare gli scenari utente
I test e l'uso di un'applicazione potrebbero avere già fornito modelli individuabili che un'estensione della classe helper può essere in grado di diagnosticare e eventualmente ripristinare. Gli sviluppatori di applicazioni possono usare questi dati per determinare i problemi di connettività più importanti da risolvere e identificare gli scenari utente in cui si verificano problemi di connettività.
Determinare la causa radice di ogni problema è fondamentale in questa parte del processo. Ciò può richiedere ricerche estese, ma aiuterà a creare software che è molto più facile per gli utenti e gli amministratori di usare. Se non viene identificata una causa radice, diventa difficile o impossibile offrire la risoluzione dei problemi usando l'estensione della classe helper.
Fornire risoluzioni
Dopo che un team di sviluppo ha identificato le cause radice dei problemi associati al software, il passaggio successivo consiste nell'identificare le azioni di risoluzione appropriate per aiutare l'utente a risolvere il problema in modo più efficiente possibile.
Non tutte le risoluzioni richiedono che venga creata un'estensione della classe helper o un'azione automatizzata. In alcuni casi, il team può determinare che l'approccio migliore per risolvere una causa radice consiste nel correggere o aggiornare il componente, fornire contenuto di aiuto aggiuntivo per il componente o sviluppare altre strategie che forniscono soluzioni a lungo termine migliori.
Per i problemi in cui un'azione automatizzata è ideale, la creazione di un'estensione della classe helper NDF è spesso una soluzione eccellente.
Le estensioni della classe helper restituiscono informazioni sulle cause radice e ripristinare le informazioni agli utenti tramite NDF. Le stringhe usate per descrivere le cause radice e le informazioni di riparazione devono essere semplici e facili da comprendere da un utente non tecnico. Per altre informazioni su queste stringhe, vedere Linee guida per l'interfaccia utente per le estensioni della classe helper NDF.
Definire un modello di integrità dei componenti
Gli sviluppatori software devono definire livelli di "integrità" associati alla gestibilità dei problemi di rete. Un modello di integrità usato per sviluppare classi helper definisce solo due livelli di integrità: integrità e non integrità. Questi livelli possono essere applicati anche alle estensioni della classe helper NDF.
Un componente integro indica un'assenza di problemi. Un componente può essere considerato non integro a causa dei propri problemi o a causa di problemi che si verificano in altri componenti su cui dipende.
| Termine | Descrizione |
|---|---|
|
LowHealth |
Questo stato indica un livello inaccettabile di errori da questo componente e che il componente è il problema. |
|
LowHealth di seguito |
Questo stato indica un livello inaccettabile di errori da un componente del computer locale a seconda di questo componente. |
Quando si esegue la diagnosi usando NDF, viene chiesto un serie di domande per determinare lo stato di integrità. Se l'estensione risponde che non è integra, NDF pone domande chiare, cercando di diagnosticare il problema, la sua posizione e dove guardare avanti. Ogni classe helper deve essere in grado di rispondere alla domanda di bassa integrità per indirizzare meglio le attività di diagnostica appropriate.