DOT11EXTIHV_QUERY_UI_REQUEST Rückruffunktion (wlanihv.h)

Artikel
02/27/2024

Wichtig Die native WLAN-Schnittstelle 802.11 ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows driver model.

Das Betriebssystem ruft die Dot11ExtIhvQueryUIRequest-Funktion auf, wenn sich die Verbindung ändert status. Wenn diese Funktion aufgerufen wird, gibt die DLL für IHV-Erweiterungen eine DOT11EXT_IHV_UI_REQUEST Struktur zurück, die das Betriebssystem für eine UI-Anforderung verwenden kann.

Syntax

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

Parameter

[in, optional] hIhvExtAdapter

Das Handle, das von der DLL für IHV-Erweiterungen verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] connectionPhase

Die aktuelle Verbindungsphase. Der Datentyp für diesen Member ist die DOT11EXT_IHV_CONNECTION_PHASE-Enumeration :

connection_phase_any

Gibt eine beliebige Verbindungsphase an.

connection_phase_initial_connection

Gibt die Verbindungsphase an, bevor die DLL für IHV-Erweiterungen einen Vorgang vor der Zuordnung initiiert. Weitere Informationen zum Vorgang vor der Zuordnung finden Sie unter Vorgänge vor der Zuordnung.

connection_phase_post_l3_connection

Gibt die Verbindungsphase an, nachdem die DLL für IHV-Erweiterungen einen Vorgang nach der Zuordnung abgeschlossen hat. Weitere Informationen zum Vorgang nach der Zuordnung finden Sie unter Vorgänge nach der Zuordnung.

[out] ppIhvUIRequest

Die Adresse eines Zeigers auf eine DOT11EXT_IHV_UI_REQUEST-Struktur . Die DLL für IHV-Erweiterungen muss einen Puffer für die DOT11EXT_IHV_UI_REQUEST-Struktur zuordnen, indem Dot11ExtAllocateBuffer aufgerufen wird.

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Wenn Dot11ExtIhvQueryUIRequest aufgerufen wird, muss die DLL für IHV-Erweiterungen einen Puffer zuordnen und zurückgeben, der als DOT11EXT_IHV_UI_REQUEST-Struktur formatiert ist. In diesem Fall muss die DLL die folgenden Richtlinien befolgen:

Die DLL für IHV-Erweiterungen muss Dot11ExtAllocateBuffer aufrufen, um den Puffer zuzuweisen. Nachdem die DLL aus Dot11ExtIhvQueryUIRequest zurückgegeben wurde, ist das Betriebssystem für den Aufruf von Dot11ExtFreeBuffer verantwortlich, um den Puffer frei zu geben.
Die DLL für IHV-Erweiterungen formatiert die DOT11EXT_IHV_UI_REQUEST-Struktur für eine UI-Anforderung, die für die Änderung der Verbindung status.
Wenn connectionPhase beispielsweise auf connection_phase_initial_connection festgelegt ist, kann die DLL für IHV-Erweiterungen festlegen, dass die Member der DOT11EXT_IHV_UI_REQUEST-Struktur auf eine Benutzeroberflächenseite verweisen, die den Benutzer über den Start des Verbindungsvorgangs benachrichtigt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (wlanihv.h einschließen)