Diseño de extensiones de clase auxiliares de NDF
Este tema está pensado para proporcionar instrucciones genéricas a través del proceso de desarrollo de extensiones de clase auxiliar. Las instrucciones de este tema se aplican a todas las extensiones de clase auxiliar. Para obtener instrucciones más específicas, consulta Windows Filtering Platform Extensible Helper Class y 802.11 Wireless Diagnostics Extensible Helper Classes.
Extensión de la funcionalidad de NDF
Windows Vista y versiones posteriores se incluyen con una variedad de clases auxiliares ya implementadas que pueden diagnosticar y reparar una amplia gama de problemas. Sin embargo, en ocasiones, es posible que los desarrolladores de terceros deseen ampliar estas clases auxiliares para diagnosticar y resolver problemas específicos de sus productos e implementaciones concretos.
Las siguientes clases auxiliares de NDF de Microsoft son extensibles.
Implementación de una extensión de clase auxiliar
Microsoft incluye dos interfaces que se pueden usar para desarrollar extensiones de clase auxiliares de NDF.
NDF llama a la interfaz INetDiagHelperInfo para validar que tiene toda la información necesaria y que ha elegido la clase auxiliar correcta. Esto se logra a través del método GetAttributeInfo .
NDF llama a la interfaz INetDiagHelper para la mayoría de las actividades que se producen durante el procedimiento de diagnóstico. Se requieren varios de sus métodos, pero otros son opcionales para usos específicos.
Los métodos necesarios incluyen Initialize y GetDiagnosticsInfo. NDF llama a Initialize para enviar parámetros clave a la extensión de clase auxiliar para inicializar su estado de instancia. GetDiagnosticsInfo proporciona una estimación del tiempo que puede tardar el diagnóstico y si requiere suplantación del contexto de usuario original.
Se llama a otro método, LowHealth, para realizar el diagnóstico en el componente de red correspondiente a la clase auxiliar. Se llama a Cancel cuando NDF determina que se debe detener un diagnóstico o reparación continuos. La limpieza permite que NDF libere los recursos de NDF que ha usado la extensión de clase auxiliar desde que se realizó la llamada a Initialize .
Para obtener información sobre métodos adicionales, consulte INetDiagHelper.
Las extensiones de clase auxiliar de NDF se usan para diagnosticar y resolver problemas de conectividad asociados a una aplicación o componente específicos. También validan el éxito o el error de un intento de resolución.
Los desarrolladores que consideren la implementación de una extensión de clase auxiliar deben realizar las siguientes tareas.
- Identificar los escenarios de usuario en los que las acciones de diagnóstico y reparación son útiles.
- Proporcione soluciones a problemas de conectividad detectados con frecuencia.
- Si se requiere una extensión de clase auxiliar, defina un modelo de mantenimiento de componentes usado para representar el estado de mantenimiento del componente en NDF.
Identificación de escenarios de usuario
Es posible que las pruebas y el uso de una aplicación ya hayan proporcionado patrones reconocibles que una extensión de clase auxiliar pueda diagnosticar y posiblemente reparar. Los desarrolladores de aplicaciones pueden usar estos datos para determinar los problemas de conectividad más importantes para solucionar e identificar los escenarios de usuario en los que es probable que se produzcan problemas de conectividad.
Determinar la causa principal de cada problema es fundamental en esta parte del proceso. Esto puede requerir una amplia investigación, pero ayudará a crear software que sea mucho más fácil para que los usuarios y los administradores los usen. Si no se identifica una causa principal, resulta difícil o imposible ofrecer la resolución de problemas mediante la extensión de clase auxiliar.
Proporcionar resoluciones
Una vez que un equipo de desarrollo ha identificado las causas principales de los problemas asociados con su software, el siguiente paso es identificar las acciones de resolución adecuadas para ayudar al usuario a resolver el problema de la forma más eficaz posible.
No todas las resoluciones requieren que se cree una extensión de clase auxiliar o una acción automatizada. En algunos casos, el equipo puede determinar que el mejor enfoque para resolver una causa principal es corregir o actualizar el componente, proporcionar contenido de ayuda adicional para el componente o desarrollar otras estrategias que proporcionen mejores soluciones a largo plazo.
Para problemas en los que una acción automatizada es ideal, la creación de una extensión de clase auxiliar de NDF suele ser una solución excelente.
Las extensiones de clase auxiliar devuelven información sobre las causas principales y la información de reparación a los usuarios a través de NDF. Las cadenas usadas para describir las causas principales y la información de reparación deben ser sencillas y fáciles para que un usuario no técnico comprenda. Para obtener más información sobre estas cadenas, vea User Interface Guidelines for NDF Helper Class Extensions.
Definir un modelo de mantenimiento de componentes
Los desarrolladores de software deben definir niveles de "mantenimiento" asociados a la capacidad de administración de los problemas de red. Un modelo de mantenimiento que se usa para desarrollar clases auxiliares define solo dos niveles de mantenimiento: correcto y incorrecto. Estos niveles también se pueden aplicar a las extensiones de clase auxiliar de NDF.
Un componente correcto indica una ausencia de problemas. Un componente se puede considerar incorrecto debido a sus propios problemas o debido a problemas que se producen en otros componentes en los que depende.
| Término | Descripción |
|---|---|
|
LowHealth |
Este estado indica un nivel inaceptable de errores de este componente y que el componente es el problema. |
|
LowHealth a continuación |
Este estado indica un nivel inaceptable de errores de un componente de equipo local del que depende este componente. |
Cuando se realiza el diagnóstico mediante NDF, la extensión de clase auxiliar se formula una serie de preguntas para determinar su estado de mantenimiento. Si la extensión responde que es incorrecta, NDF formula preguntas aclarantes, intenta diagnosticar el problema, su ubicación y dónde buscar a continuación. Cada clase auxiliar debe ser capaz de responder a la pregunta de baja salud para dirigir mejor las actividades de diagnóstico adecuadas.