DOT11EXTIHV_PERFORM_CAPABILITY_MATCH funzione di callback (wlanihv.h)

  • Articolo
Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

Il sistema operativo chiama la funzione Dot11ExtIhvPerformCapabilityMatch per richiedere che la DLL delle estensioni IHV determini se una rete BSS (Basic Service Set) rilevata corrisponde alle estensioni del profilo di connettività e sicurezza definite dall'IHV.

Sintassi

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
)
{...}

Parametri

[in, optional] hIhvExtAdapter

Handle utilizzato dalla DLL delle estensioni IHV per fare riferimento alla scheda LAN wireless (WLAN). Questo valore handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] pIhvProfileParams

Puntatore a DOT11EXT_IHV_PROFILE_PARAMS struttura. Questa struttura definisce gli attributi della rete BSS (Basic Service Set) a cui verranno applicate le estensioni del profilo.

[in] pIhvConnProfile

Puntatore a DOT11EXT_IHV_CONNECTIVITY_PROFILE struttura che contiene le impostazioni di connettività per il profilo IHV.

[in] pIhvSecProfile

Puntatore a DOT11EXT_IHV_SECURITY_PROFILE struttura che contiene le impostazioni di sicurezza per il profilo IHV.

[in, optional] pConnectableBssid

Puntatore a una struttura di DOT11_BSS_LIST , che contiene uno o più frame beacon o probe di risposta 802.11 ricevuti da una rete BSS. Questo elenco è derivato dai risultati dell'ultima operazione di analisi eseguita dalla scheda WLAN. Per altre informazioni sull'operazione di analisi, vedere Operazioni di analisi native 802.11.

Nota Per Windows Vista, la DLL delle estensioni IHV supporta solo le reti BSS (Infrastructure Basic Service Set).

[out] pdwReasonCode

Puntatore a un valore DWORD, che fornisce informazioni aggiuntive per il valore restituito della funzione Dot11ExtIhvPerformCapabilityMatch . La DLL delle estensioni IHV deve impostare * pdwReasonCode su un valore L2_REASON_CODE_xxxx, definito in L2cmn.h.

Valore restituito

Se tutte le voci nell'elenco di 802.11 Beacon e Probe Response frame supportano gli attributi di connettività e sicurezza definiti nei frammenti di profilo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Commenti

Dopo aver completato un'operazione di analisi per rilevare le reti BSS all'interno dell'intervallo, il sistema operativo potrebbe chiamare la funzione Dot11ExtIhvPerformCapabilityMatch per determinare se una delle reti BSS rilevate corrisponde alle estensioni del profilo di sicurezza o di connettività definite dall'IHV.

Quando viene chiamata la funzione Dot11ExtIhvPerformCapabilityMatch , la DLL delle estensioni IHV deve seguire queste linee guida.

  • Se la DLL delle estensioni IHV trova almeno un frame beacon IEEE 802.11 o probe che corrisponde ai frammenti di profilo, deve impostare * pdwReasonCode su uno dei seguenti:
    • L2_REASON_CODE_SUCCESS.
    • Valore definito da IHV nell'intervallo compreso tra L2_REASON_CODE_IHV_BASE e (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    In questo caso, la funzione Dot11ExtIhvPerformCapabilityMatch deve restituire ERROR_SUCCESS.
  • Se la DLL delle estensioni IHV non trova un frame beacon o probe IEEE 802.11 che corrisponde ai frammenti di profilo, non deve impostare *pdwReasonCode su L2_REASON_CODE_SUCCESS. Al contrario, la DLL deve impostare * pdwReasonCode su uno dei seguenti:
    • Valore di errore L2_REASON_CODE_xxxx appropriato.
    • Valore definito da IHV nell'intervallo compreso tra L2_REASON_CODE_IHV_BASE e (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    In questo caso, la funzione Dot11ExtIhvPerformCapabilityMatch non deve restituire ERROR_SUCCESS.
Per altre informazioni su XML Schema nativo 802.11, vedere la documentazione di Microsoft Windows SDK.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione wlanihv.h (include Wlanihv.h, Winclient.h, L2cmn.h)

Vedi anche

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS