Erweitern von Drahtlosverbindungseigenschaften
In diesem Thema wird beschrieben, wie eine NATIVE 802.11-DLL für IHV-UI-Erweiterungen die Eigenschaften auf der Registerkarte Verbindung erweitert, die über die Benutzeroberfläche (Ui) der Netzwerkkonfiguration angezeigt werden. In diesem Fall fügt die DLL Native 802.11 IHV UI Extensions der Registerkarte Verbindung Eigenschaften für proprietäre Verbindungseinstellungen hinzu.
Weitere Informationen zur Benutzeroberfläche der Netzwerkkonfiguration und anderen Native 802.11-Komponenten finden Sie unter Native 802.11-Softwarearchitektur.
Bevor die Registerkarte Verbindung angezeigt wird, führt das Betriebssystem folgendes aus:
Fragt die NATIVE 802.11-DLL für IHV-UI-Erweiterungen über einen Aufruf der IDot11ExtUI::GetDot11ExtUIProperties-Methode nach ihren Verbindungseigenschaften ab. Das Betriebssystem übergibt den Wert DOT11_EXT_UI_CONNECTION an den ExtType-Parameter der Methode.
Wenn die NATIVE 802.11 IHV UI Extension DLL eine Eigenschaft vom Typ DOT11_EXT_UI_CONNECTION unterstützt, gibt die DLL (über den ppDot11ExtUIProperty-Parameter der Methode) die Adresse der IDot11ExtUIProperty COM-Schnittstelle zurück, die die Verbindungseigenschaftserweiterung implementiert. Weitere Informationen zu den COM-Schnittstellen, die zum Erweitern von Verbindungseigenschaften verwendet werden, finden Sie unter NATIVE 802.11 IHV UI Extensions COM Interfaces.
Hinweis Für Windows Vista darf die NATIVE 802.11 IHV UI Extensions DLL nicht mehr als eine IDot11ExtUI COM-Schnittstelle für eine Verbindungseigenschaftserweiterung zurückgeben.
Wenn die DLL native 802.11 IHV UI Extensions eine Verbindungseigenschaft unterstützt, fragt das Betriebssystem den Anzeigenamen der Eigenschaftenerweiterung ab, indem es die IDot11ExtUIProperty::GetDot11ExtUIPropertyFriendlyName-Methode der Erweiterung aufruft . Das Betriebssystem fügt den Anzeigenamen im Text " xxx-Verbindungseinstellungen aktivieren" ein, wobei "xxx" der Anzeigename der Eigenschaftenerweiterung ist. Das Betriebssystem zeigt diesen Text zusammen mit einem Kontrollkästchen auf der Registerkarte Verbindung an.
Fragt die Erweiterung ab, um zu bestimmen, ob sie über eine benutzerdefinierte UI-Eigenschaft verfügt, die angezeigt werden kann. Dazu ruft das Betriebssystem die IDot11ExtUIProperty::D ot11ExtUIPropertyHasConfigurationUI-Methode der Erweiterung auf. Wenn die Verbindungseigenschaftserweiterung eine benutzerdefinierte UI-Eigenschaft unterstützt, fügt das Betriebssystem eine Schaltfläche Konfigurieren unterhalb des Kontrollkästchens für die Eigenschaft hinzu.
Wenn die ausgewählte proprietäre Verbindungseinstellung eine Konfigurationsbenutzeroberfläche unterstützt und der Endbenutzer auf der RegisterkarteVerbindung auf die Schaltfläche Konfigurieren klickt, ruft das Betriebssystem die IDot11ExtUIProperty::D isplayDot11ExtUIProperty-Methode der Verbindungseigenschaftserweiterung auf, um die benutzerdefinierte Benutzeroberfläche zu starten. Das Betriebssystem übergibt die aktuellen Profildaten für die Erweiterung über das bstrIHVProfile-Argument der Methode.
Die Profildaten sind als XML-Fragment formatiert, das durch die <IHV></IHV-XML-Tags> begrenzt ist. Die XML-Daten in diesen Tags sind spezifisch für die Implementierung des IHV und für das Betriebssystem undurchsichtig. Weitere Informationen zum Format der Nativen 802.11-Profildaten finden Sie in der Dokumentation im Microsoft Windows SDK.
Wenn die Profildaten über die benutzerdefinierte Benutzeroberfläche geändert werden, muss die IDot11ExtUIProperty::D isplayDot11ExtUIProperty-Methode der Erweiterung vor der Rückgabe folgendes ausführen:
Ordnen Sie einen Zeichenfolgenpuffer für die geänderten Profildaten zu, und geben Sie einen Zeiger auf den Puffer über den bstrModifiedIHVProfile-Parameter der Methode zurück. Hinweis Die IDot11ExtUIProperty::D isplayDot11ExtUIProperty-Methode der Erweiterung darf die Daten, auf die vom bstrIHVProfile-Argument verwiesen wird, nicht ändern.
Legen Sie das Argument pbIsModified auf TRUE fest.