Extension des propriétés de connexion sans fil
Cette rubrique décrit comment une DLL d’extensions d’interface utilisateur IHV Native 802.11 étend les propriétés de l’onglet Connexion qui s’affichent via l’interface utilisateur de configuration réseau. Dans ce cas, la DLL Extensions d’interface utilisateur IHV Native 802.11 ajoute des propriétés à l’onglet Connexion pour les paramètres de connexion propriétaires.
Pour plus d’informations sur l’interface utilisateur de configuration réseau et d’autres composants natives 802.11, consultez Architecture logicielle native 802.11.
Avant d’afficher l’onglet Connexion , le système d’exploitation effectue les opérations suivantes :
Interroge la DLL Native 802.11 IHV UI Extensions pour ses propriétés de connexion via un appel à la méthode IDot11ExtUI::GetDot11ExtUIProperties . Le système d’exploitation transmet une valeur de DOT11_EXT_UI_CONNECTION au paramètre ExtType de la méthode.
Si la DLL d’extension iHV native 802.11 prend en charge une propriété de type DOT11_EXT_UI_CONNECTION, la DLL retourne (via le paramètre ppDot11ExtUIProperty de la méthode) l’adresse de l’interface COM IDot11ExtUIProperty, qui implémente l’extension de propriété de connexion. Pour plus d’informations sur les interfaces COM utilisées pour étendre les propriétés de connexion, consultez Interfaces COM des extensions d’interface utilisateur IHV natives 802.11.
Note Pour Windows Vista, la DLL Native 802.11 IHV UI Extensions ne doit pas retourner plusieurs IDot11ExtUI COM Interface pour une extension de propriété de connexion.
Si la DLL Native 802.11 IHV UI Extensions prend en charge une propriété de connexion, le système d’exploitation interroge le nom convivial de l’extension de propriété en appelant la méthode IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName de l’extension . Le système d’exploitation insère le nom convivial dans le texte « Activer xxx paramètres de connexion », où « xxx » est le nom convivial de l’extension de propriété. Le système d’exploitation affiche ce texte ainsi qu’une zone de case activée sous l’onglet Connexion.
Interroge l’extension pour déterminer si elle a une propriété d’interface utilisateur personnalisée qui peut être affichée. Pour ce faire, le système d’exploitation appelle la méthode IDot11ExtUIProperty::D ot11ExtUIPropertyHasConfigurationUIUI. Si l’extension de propriété de connexion prend en charge une propriété d’interface utilisateur personnalisée, le système d’exploitation ajoute un bouton Configurer sous la zone case activée pour la propriété.
Si le paramètre de connexion propriétaire sélectionné prend en charge une interface utilisateur de configuration et que l’utilisateur final clique sur le bouton Configurer sous l’ongletConnexion , le système d’exploitation appelle la méthode IDot11ExtUIProperty::D isplayDot11ExtUIProperty de l’extension de propriété de connexion pour lancer l’interface utilisateur personnalisée. Le système d’exploitation transmet les données de profil actuelles pour l’extension via l’argument bstrIHVProfile de la méthode.
Les données de profil sont mises en forme en tant que fragment XML limité par les <balises XML IHV></IHV> . Les données XML contenues dans ces balises sont spécifiques à l’implémentation de l’IHV et sont opaques pour le système d’exploitation. Pour plus d’informations sur le format des données de profil Native 802.11, reportez-vous à la documentation dans le Microsoft Windows SDK.
Si les données de profil sont modifiées via l’interface utilisateur personnalisée, la méthode IDot11ExtUIProperty::D isplayDot11ExtUIProperty de l’extension doit effectuer les opérations suivantes avant de retourner :
Allouez une mémoire tampon de chaîne pour les données de profil modifiées et retournez un pointeur vers la mémoire tampon via le paramètre bstrModifiedIHVProfile de la méthode. Note La méthode IDot11ExtUIProperty::D isplayDot11ExtUIProperty de l’extension ne doit pas modifier les données référencées par l’argument bstrIHVProfile .
Définissez l’argument pbIsModified sur TRUE.