Extensión de las propiedades de conexión inalámbrica
En este tema se describe cómo un archivo DLL de extensiones de interfaz de usuario IHV nativa 802.11 amplía las propiedades de la pestaña Conexión que se muestran a través de la interfaz de usuario (UI) de configuración de red. En esta situación, el archivo DLL de extensiones de interfaz de usuario IHV nativa 802.11 agrega propiedades a la pestaña Conexión para la configuración de conexión propietaria.
Para obtener más información sobre la interfaz de usuario de configuración de red y otros componentes nativos de 802.11, consulte Arquitectura de software nativa 802.11.
Antes de mostrar la pestaña Conexión , el sistema operativo hace lo siguiente:
Consulta el archivo DLL de extensiones de interfaz de usuario de IHV nativo 802.11 para sus propiedades de conexión a través de una llamada al método IDot11ExtUI::GetDot11ExtUIProperties . El sistema operativo pasa un valor de DOT11_EXT_UI_CONNECTION al parámetro ExtType del método.
Si el archivo DLL de extensión de interfaz de usuario IHV nativa 802.11 admite una propiedad de tipo DOT11_EXT_UI_CONNECTION, el archivo DLL devuelve (a través del parámetro ppDot11ExtUIProperty del método), la dirección de la interfaz COM IDot11ExtUIProperty, que implementa la extensión de la propiedad de conexión. Para obtener más información sobre las interfaces COM que se usan para ampliar las propiedades de conexión, consulte Interfaces COM de extensiones COM de extensiones de interfaz de usuario IHV nativas 802.11.
Nota Para Windows Vista, el archivo DLL de extensiones de interfaz de usuario IHV nativa 802.11 no debe devolver más de una interfaz COM IDot11ExtUI para una extensión de propiedad de conexión.
Si el archivo DLL de extensiones de interfaz de usuario IHV nativa 802.11 admite una propiedad de conexión, el sistema operativo consulta el nombre descriptivo de la extensión de propiedad llamando al método IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName de la extensión. El sistema operativo inserta el nombre descriptivo en el texto "Habilitar la configuración de conexión xxx ", donde "xxx" es el nombre descriptivo de la extensión de propiedad. El sistema operativo muestra este texto junto con una casilla en la pestaña Conexión .
Consulta la extensión para determinar si tiene una propiedad de interfaz de usuario personalizada que se puede mostrar. El sistema operativo lo hace llamando al método IDot11ExtUIProperty::D ot11ExtUIPropertyHasConfigurationUI de la extensión. Si la extensión de propiedad de conexión admite una propiedad de interfaz de usuario personalizada, el sistema operativo agrega un botón Configurar debajo de la casilla de verificación de la propiedad .
Si la configuración de conexión propietaria seleccionada admite una interfaz de usuario de configuración y el usuario final hace clic en el botón Configurar de la pestañaConexión , el sistema operativo llama al método IDot11ExtUIProperty::D isplayDot11ExtUIProperty para iniciar la interfaz de usuario personalizada. El sistema operativo pasa los datos de perfil actuales de la extensión a través del argumento bstrIHVProfile del método.
Los datos de perfil tienen el formato de fragmento XML limitado por las <etiquetas XML de IHV></IHV> . Los datos XML de estas etiquetas son específicos de la implementación de IHV y son opacos para el sistema operativo. Para obtener más información sobre el formato de los datos de perfil de Native 802.11, consulte la documentación de la Microsoft Windows SDK.
Si los datos del perfil se cambian a través de la interfaz de usuario personalizada, el método IDot11ExtUIProperty::D isplayDot11ExtUIProperty de la extensión debe hacer lo siguiente antes de devolver:
Asigne un búfer de cadena para los datos de perfil modificados y devuelva un puntero al búfer a través del parámetro bstrModifiedIHVProfile del método. Nota El método IDot11ExtUIProperty::D isplayDot11ExtUIProperty de la extensión no debe modificar los datos a los que hace referencia el argumento bstrIHVProfile .
Establezca el argumento pbIsModified en TRUE.