Zugreifen auf Profil- und Kontextdaten
Eine benutzerdefinierte Benutzeroberfläche, die von der Native 802.11 IHV UI Extensions DLL unterstützt wird, kann über eine der folgenden Optionen angezeigt werden:
Ein Aufruf von Dot11ExtSendUIRequest von der Native 802.11 IHV Extensions DLL. Weitere Informationen zu diesem Prozess finden Sie unter Anfordern der Anzeige einer benutzerdefinierten Benutzeroberfläche.
Ein Aufruf der Dot11ExtQueryUIRequest IHV-Handler-Funktion von Native 802.11 IHV Extensions DLL vom Betriebssystem. Weitere Informationen zu diesem Prozess finden Sie unter Abfragen für die Anzeige einer benutzerdefinierten Benutzeroberfläche.
Unabhängig davon, ob die UI-Anforderung entweder über eine Ballonbenachrichtigung oder den Netzwerkverbindungs-Assistenten des Betriebssystems angezeigt wird, kann die NATIVE 802.11-DLL für IHV-UI-Erweiterungen auf die folgenden Daten zugreifen:
Netzwerkverbindungsprofildaten
Wenn die benutzerdefinierte Benutzeroberfläche im Netzwerkverbindungs-Assistenten angezeigt wird, kann die NATIVE 802.11-DLL für IHV-UI-Erweiterungen auf den IHV-definierten Teil des aktuellen Netzwerkverbindungsprofils zugreifen. Diese Daten 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.
Der Zugriff auf die Profildaten erfolgt über die Read - und Write-Methoden der IPropertyBag-COM-Schnittstelle für eine Eigenschaft namens IHV_PROFILE_DATA.
Kontextdaten
Die native 802.11 IHV-Erweiterungen-DLL gibt eine benutzerdefinierte Benutzeroberfläche über eine DOT11EXT_IHV_UI_REQUEST-Struktur an, die sowohl in der Dot11ExtSendUIRequest-Funktion als auch in der Dot11ExtSendUIRequest-Funktion als Argument übergeben wird. Innerhalb der DOT11EXT_IHV_UI_REQUEST-Struktur kann der IHV (über das pvUIRequest-Element ) Kontextdaten bereitstellen, die für die benutzerdefinierte Benutzeroberfläche spezifisch sind. In der Regel formatiert der IHV diese Daten mit Standardeinstellungen für die benutzerdefinierte Benutzeroberfläche.
Der Zugriff auf die Profildaten erfolgt über die Read - und Write-Methoden der IPropertyBag COM-Schnittstelle für eine Eigenschaft namens IHV_NOTIFICATION_DATA.
Die NATIVE 802.11 IHV UI Extensions DLL greift auf die IPropertyBag COM-Schnittstelle über den IUnknown-Zeiger zu, der über die IObjectWithSite::SetSite-Methode zurückgegeben wird. Weitere Informationen finden Sie unter IObjectWithSite.
Alternativ zur IPropertyBag COM-Schnittstelle kann die Native 802.11 IHV UI Extensions DLL über die GetProp Win32-Funktion auf die eigenschaften IHV_PROFILE_DATA und IHV_NOTIFICATION_DATA zugreifen. In dieser Situation muss die DLL das Handle des übergeordneten Fensters verwenden, wie im folgenden Beispiel gezeigt:
LPWSTR lpszBuffer = (LPWSTR) GetProp(GetParent(hwndDlg), L"IHV_PROFILE_DATA");