DOT11EXTIHV_PERFORM_PRE_ASSOCIATE funzione di callback (wlanihv.h)

Articolo
02/07/2025

importante L'interfaccia LAN wireless 802.1 1 nativa è 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 di Windows universale WLAN.

Il sistema operativo chiama la funzione Dot11ExtIhvPerformPreAssociate per richiedere che la DLL delle estensioni IHV avvii un'operazione di pre-associazione con la rete BSS (Basic Service Set).

Sintassi

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           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 di handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] hConnectSession

Handle utilizzato dal sistema operativo per fare riferimento alla sessione di connessione con la rete BSS (Basic Service Set).

[in, optional] pIhvProfileParams

Puntatore a un 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 un DOT11EXT_IHV_CONNECTIVITY_PROFILE struttura che contiene le impostazioni di connettività per il profilo IHV.

[in] pIhvSecProfile

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

[in] pConnectableBssid

Puntatore a una struttura DOT11_BSS_LIST, che contiene uno o più frame beacon o probe di risposta 802.11 per l'identificatore del set di servizi (SSID) della rete BSS con cui la DLL eseguirà l'operazione di pre-associazione.

[out] pdwReasonCode

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

Valore restituito

Se la DLL dell'estensione IHV può avviare l'operazione di pre-associazione, deve completare l'operazione in modo asincrono. In questo caso, la funzione restituisce ERROR_SUCCESS.

Se la DLL delle estensioni IHV non può avviare l'operazione di pre-associazione, restituisce un codice di errore definito in Winerror.h.

Osservazioni

Il sistema operativo chiama la funzione Dot11ExtIhvPerformPreAssociate per avviare un'operazione di pre-associazione con la DLL delle estensioni IHV. Il sistema operativo avvia questa operazione prima di avviare un'operazione di connessione con una rete BSS (Basic Service Set) tramite la scheda WLAN. Per altre informazioni sull'operazione di connessione, vedere Operazioni di connessione.

L'operazione di pre-associazione deve essere completata in modo asincrono dalla chiamata a Dot11ExtIhvPerformPreAssociate. Al termine dell'operazione di pre-associazione, la DLL delle estensioni IHV deve chiamare Dot11ExtPreAssociateCompletion.

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

Se la DLL delle estensioni IHV può avviare l'operazione di pre-associazione, la funzione Dot11ExtIhvPerformPreAssociate deve restituire ERROR_SUCCESS e completare l'operazione in modo asincrono.
La DLL delle estensioni IHV fornisce altre informazioni sull'avvio dell'operazione di pre-associazione tramite il parametro pdwReasonCode. La DLL deve impostare * pdwReasonCode su uno dei seguenti:
- L2_REASON_CODE_SUCCESS, se l'operazione di pre-associazione può essere avviata correttamente.
- Valore di errore L2_REASON_CODE_xxxx appropriato, se non è stato possibile avviare l'operazione di pre-associazione.
- 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), indipendentemente dal fatto che l'operazione di prea associazione possa essere avviata o meno.

Per altre informazioni sull'operazione di pre-associazione, vedere 'operazione di pre-associazione.

Fabbisogno

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, L2cmn.h)