Progettazione di estensioni della classe helper NDF
Questo argomento è destinato a fornire indicazioni generice tramite il processo di sviluppo delle estensioni della classe helper. Le linee guida contenute in questo argomento si applicano a tutte le estensioni della classe helper. Per indicazioni più specifiche, vedere Classe Helper Estensibile della Piattaforma di Filtro di Windows e Classi Helper Estensibili di Diagnostica Wireless 802.11.
Estensione della funzionalità NDF
Windows Vista e versioni successive vengono forniti con un'ampia gamma di classi helper già implementate che possono diagnosticare e risolvere un'ampia gamma di problemi. A volte, tuttavia, gli sviluppatori di terze parti potrebbero voler estendere queste classi helper per diagnosticare e risolvere i problemi specifici dei prodotti e delle implementazioni specifici.
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 di 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 metodoGetAttributeInfo.
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 obbligatori includono Initialize e GetDiagnosticsInfo. NDF chiama Initialize per inviare parametri chiave all'estensione della classe di supporto per inizializzare lo stato della sua istanza. GetDiagnosticsInfo fornisce una stima del tempo necessario per la diagnosi e se richiede la rappresentazione del contesto utente originale.
Un altro metodo, LowHealth, viene chiamato per eseguire la diagnosi sul componente di rete corrispondente alla classe helper. si attiva Cancel quando NDF determina che una diagnosi o una riparazione in corso deve essere interrotta. Cleanup consente a NDF di rilasciare le risorse NDF che sono state utilizzate dall'estensione della classe helper dopo che è stata effettuata 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 le azioni di diagnostica e ripristino sono utili.
- Fornire soluzioni ai problemi di connettività riscontrati di frequente.
- Se è necessaria un'estensione della classe helper, definire un modello di integrità del componente 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 discernebili che un'estensione della classe helper può essere in grado di diagnosticare ed 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 possono verificarsi problemi di connettività.
Determinare la causa radice di ogni problema è fondamentale in questa parte del processo. Ciò può richiedere una ricerca approfondita, ma contribuirà a creare software molto più semplice per gli utenti e gli amministratori da 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 principali dei problemi associati al software, il passaggio successivo consiste nell'identificare le azioni di risoluzione appropriate per aiutare l'utente a risolvere il problema nel modo più efficiente possibile.
Non tutte le risoluzioni richiedono la creazione di un'estensione della classe helper o di un'azione automatica. 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 aggiuntivo della Guida per il componente o sviluppare altre strategie che forniscono soluzioni a lungo termine migliori.
Per i problemi in cui un'azione automatica è ideale, la creazione di un'estensione di classe helper NDF è spesso una soluzione eccellente.
Le estensioni della classe helper restituiscono informazioni sulle cause principali e sulle modalità di risoluzione agli utenti tramite NDF. Le stringhe usate per descrivere le cause radice e le informazioni di ripristino devono essere semplici e facili da comprendere per un utente non tecnico. Per altre informazioni su queste stringhe, vedere User Interface Guidelines for NDF Helper Class Extensions.
Definire un modello di integrità dei componenti
Gli sviluppatori di 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à: integro e non integro. 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 da cui dipende.
| Termine | Descrizione |
|---|---|
|
LowHealth |
Questo stato indica un livello inaccettabile di errori di 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 da cui dipende questo componente. |
Quando viene eseguita la diagnosi tramite NDF, viene posta una serie di domande all'estensione della classe di supporto per determinare il suo stato di salute. Se l'estensione risponde che non è funzionante, NDF pone domande chiarificatrici, cercando di diagnosticare il problema, la sua posizione e il prossimo punto da esaminare. Ogni classe ausiliaria deve essere in grado di rispondere alla questione della bassa salute al fine di indirizzare meglio le attività diagnostiche appropriate.