DOT11EXTIHV_PERFORM_CAPABILITY_MATCH 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 Dot11ExtIhvPerformCapabilityMatch-Funktion auf, um anzufordern, dass die DLL für IHV-Erweiterungen ermittelt, ob ein erkanntes BSS-Netzwerk (Basic Service Set) mit den vom IHV definierten Konnektivitäts- und Sicherheitsprofilerweiterungen übereinstimmt.

Syntax

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

DWORD Dot11extihvPerformCapabilityMatch(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

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, optional] pIhvProfileParams

Ein Zeiger auf eine DOT11EXT_IHV_PROFILE_PARAMS Struktur. Diese Struktur definiert die Attribute des BSS-Netzwerks (Basic Service Set), auf das die Profilerweiterungen angewendet werden.

[in] pIhvConnProfile

Ein Zeiger auf eine DOT11EXT_IHV_CONNECTIVITY_PROFILE Struktur, die Konnektivitätseinstellungen für das IHV-Profil enthält.

[in] pIhvSecProfile

Ein Zeiger auf eine DOT11EXT_IHV_SECURITY_PROFILE Struktur, die Sicherheitseinstellungen für das IHV-Profil enthält.

[in, optional] pConnectableBssid

Ein Zeiger auf eine DOT11_BSS_LIST-Struktur , die mindestens ein 802.11-Beacon- oder Testantwortframes enthält, die von einem BSS-Netzwerk empfangen werden. Diese Liste wird aus den Ergebnissen des letzten Scanvorgangs abgeleitet, der vom WLAN-Adapter ausgeführt wurde. Weitere Informationen zum Scanvorgang finden Sie unter Native 802.11-Scanvorgänge.

Hinweis Für Windows Vista unterstützt die DLL für IHV-Erweiterungen nur BSS-Netzwerke (Infrastructure Basic Service Set).

[out] pdwReasonCode

Ein Zeiger auf einen DWORD-Wert, der zusätzliche Informationen für den Rückgabewert der Dot11ExtIhvPerformCapabilityMatch-Funktion bereitstellt. Die DLL für IHV-Erweiterungen muss * pdwReasonCode auf einen L2_REASON_CODE_xxxx-Wert festlegen, der in L2cmn.h definiert ist.

Rückgabewert

Wenn alle Einträge in der Liste der 802.11 Beacon- und Testantwortframes die in den Profilfragmenten definierten Konnektivitäts- und Sicherheitsattribute unterstützen, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Nachdem der WLAN-Adapter einen Scanvorgang abgeschlossen hat, um die BSS-Netzwerke in Reichweite zu erkennen, kann das Betriebssystem die Dot11ExtIhvPerformCapabilityMatch-Funktion aufrufen, um zu bestimmen, ob eines der erkannten BSS-Netzwerke mit den vom IHV definierten Konnektivitäts- oder Sicherheitsprofilerweiterungen übereinstimmt.

Wenn die Dot11ExtIhvPerformCapabilityMatch-Funktion aufgerufen wird, muss die DLL für IHV-Erweiterungen diese Richtlinien befolgen.

Wenn die DLL für IHV-Erweiterungen mindestens einen IEEE 802.11 Beacon- oder Test Response-Frame findet, der mit den Profilfragmenten übereinstimmt, muss * pdwReasonCode auf eine der folgenden Optionen festgelegt werden:
- L2_REASON_CODE_SUCCESS.
- Ein IHV-definierter Wert im Bereich von L2_REASON_CODE_IHV_BASE bis (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
In diesem Fall muss die Dot11ExtIhvPerformCapabilityMatch-Funktion ERROR_SUCCESS zurückgeben.
Wenn die DLL für IHV-Erweiterungen keinen IEEE 802.11 Beacon- oder Test response-Frame findet, der den Profilfragmenten entspricht, darf *pdwReasonCode nicht auf L2_REASON_CODE_SUCCESS festgelegt werden. Stattdessen muss die DLL * pdwReasonCode auf eine der folgenden Festlegen:
- Ein geeigneter L2_REASON_CODE_xxxx Fehlerwert.
- Ein IHV-definierter Wert im Bereich von L2_REASON_CODE_IHV_BASE bis (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
In diesem Fall darf die Dot11ExtIhvPerformCapabilityMatch-Funktion nicht ERROR_SUCCESS zurückgeben.

Weitere Informationen zum nativen XML-Schema 802.11 finden Sie in der Microsoft Windows SDK-Dokumentation.

Anforderungen

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