Condividi tramite

Linee guida per l'operazione pre-associazione

  • Articolo

 

La DLL delle estensioni IHV deve seguire queste linee guida durante l'esecuzione dell'operazione di pre-associazione.

  • Quando viene chiamata la funzione Dot11ExtIhvPerformPreAssociate , la DLL delle estensioni IHV deve eseguire le operazioni seguenti:

    • Verificare le estensioni IHV per il profilo di connettività e sicurezza. Se i parametri del profilo non sono validi, la funzione Dot11ExtIhvPerformPreAssociate restituisce un codice di errore appropriato come definito in Winerror.h.
    • Creare e avviare un nuovo thread per il completamento dell'operazione di pre-associazione. Poiché l'operazione di pre-associazione deve essere completata in modo asincrono dalla chiamata a Dot11ExtIhvPerformPreAssociate, la DLL delle estensioni IHV deve chiamare Dot11ExtPreAssociateCompletion da questo thread dopo il completamento dell'operazione.
    • Restituire ERROR_SUCCESS dalla chiamata alla funzione. A questo punto, il sistema operativo riceve una notifica che il profilo di rete è valido e l'operazione di pre-associazione è in corso.

  • La DLL delle estensioni IHV può chiamare la funzione Dot11ExtNicSpecificExtension per configurare l'adattatore LAN wireless (WLAN). Questa funzione può essere chiamata dall'interno della chiamata a Dot11ExtIhvPerformPreAssociate o dal thread che gestisce l'operazione di pre-associazione dopo dot11ExtIhvPerformPreAssociate restituisce.

  • Le chiamate a Dot11ExtSetProfileCustomUserData, Dot11ExtGetProfileCustomUserData e Dot11ExtSetCurrentProfile non devono essere effettuate dall'interno della chiamata a Dot11ExtIhvPerformPreAssociate. Queste funzioni possono essere chiamate solo dopo Dot11ExtIhvPerformPreAssociate restituisce ERROR_SUCCESS.

  • Dopo che la DLL delle estensioni IHV chiama Dot11ExtPreAssociateCompletion per completare l'operazione di pre-associazione, l'handle per la sessione di connessione non è più valido. Il sistema operativo passa questo handle tramite il parametro hConnectSession di Dot11ExtIhvPerformPreAssociate. La DLL non deve usare questo valore di handle quando si chiamano le funzioni di estendibilità IHV che dichiarano un parametro hConnectSession .

    Per altre informazioni sulle funzioni di estendibilità IHV, vedere Funzioni di estendibilità IHV native 802.11.

  • Se viene chiamata la funzione Dot11ExtIhvAdapterReset , la DLL delle estensioni IHV deve annullare l'operazione di pre-associazione chiamando Dot11ExtPreAssociateCompletion. Per altre informazioni sull'operazione di reimpostazione, vedere Reimpostazione dell'adattatore WLAN 802.11.

  • Se viene chiamata la funzione Dot11ExtIhvDeinitAdapter , la DLL delle estensioni IHV deve annullare l'operazione di pre-associazione internamente. Tuttavia, non deve chiamare alcuna delle funzioni di estendibilità IHV che possono essere chiamate solo dopo l'inizializzazione dell'adattatore, incluso Dot11ExtPreAssociateCompletion.