DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Rückruffunktion (wlanihv.h)
Das Betriebssystem ruft die Dot11ExtIhvPerformCapabilityMatch-Funktion auf, um anzufordern, dass die IHV-Erweiterungs-DLL bestimmt, ob ein erkanntes BSS-Netzwerk (Basic Service Set) mit den vom IHV definierten Verbindungs- 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 IHV Extensions DLL verwendet wird, um auf den Wlan-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion angegeben.
[in, optional] pIhvProfileParams
Ein Zeiger auf ein 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 ein DOT11EXT_IHV_CONNECTIVITY_PROFILE Struktur, die Verbindungseinstellungen für das IHV-Profil enthält.
[in] pIhvSecProfile
Ein Zeiger auf ein 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 einen oder mehrere 802.11 Beacon- oder Probeantwortframes 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 wird. Weitere Informationen zum Scanvorgang finden Sie unter Native 802.11 Scan Operations.
[out] pdwReasonCode
Ein Zeiger auf einen DWORD-Wert, der zusätzliche Informationen für den Rückgabewert der Dot11ExtIhvPerformCapabilityMatch-Funktion bereitstellt. Die IHV Extensions DLL 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 Probeantwortframes die in den Profilfragmenten definierten Verbindungs- und Sicherheitsattribute unterstützen, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein fehlercode zurückgegeben, der in Winerror.h definiert ist.
Bemerkungen
Nachdem der WLAN-Adapter einen Scanvorgang abgeschlossen hat, um die BSS-Netzwerke innerhalb des Bereichs zu erkennen, ruft das Betriebssystem möglicherweise die Dot11ExtIhvPerformCapabilityMatch-Funktion auf, um festzustellen, ob eines der erkannten BSS-Netzwerke mit den durch den IHV definierten Verbindungs- oder Sicherheitsprofilerweiterungen übereinstimmt.
Wenn die Dot11ExtIhvPerformCapabilityMatch Funktion aufgerufen wird, muss die IHV Extensions DLL diese Richtlinien befolgen.
-
Wenn die IHV Extensions DLL mindestens einen IEEE 802.11 Beacon- oder Probe Response-Frame findet, der den Profilfragmenten entspricht, muss sie * pdwReasonCode auf einen der folgenden Werte festlegen:
- 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 IHV Extensions DLL keinen IEEE 802.11 Beacon- oder Probe Response-Frame findet, der den Profilfragmenten entspricht, darf nicht *pdwReasonCode auf L2_REASON_CODE_SUCCESS festgelegt werden. Stattdessen muss die DLL * pdwReasonCode- auf eine der folgenden Festlegen 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | wlanihv.h (einschließlich Wlanihv.h, Winclient.h, L2cmn.h) |