DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Rückruffunktion (wlanihv.h)
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.
[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).
-
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).
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) |