DOT11EXT_PRE_ASSOCIATE_COMPLETION funzione di callback (wlanihv.h)

Articolo
08/08/2023

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.

La DLL delle estensioni IHV chiama la funzione Dot11ExtPreAssociateCompletion per completare in modo asincrono un'operazione di pre-associazione avviata tramite una chiamata a . Dot11ExtIhvPerformPreAssociate Funzione gestore IHV.

Sintassi

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Parametri

[in, optional] hDot11SvcHandle

Handle utilizzato dal sistema operativo per fare riferimento alla scheda LAN wireless (WLAN). Questo valore 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). Questo valore di handle è stato specificato tramite una chiamata precedente a Dot11ExtIhvPerformPreAssociate Funzione gestore IHV.

[in] dwReasonCode

Valore che fornisce informazioni aggiuntive per lo stato di completamento dell'operazione di pre-associazione. La DLL delle estensioni IHV deve impostare dwReasonCode su un valore L2_REASON_CODE_xxxx, definito in L2cmn.h.

La DLL delle estensioni IHV restituisce lo stato di completamento generale dell'operazione di pre-associazione tramite il parametro dwWin32Error . In genere, la DLL delle estensioni IHV imposta dwReasonCode su un valore compreso nell'intervallo compreso tra L2_REASON_CODE_IHV_BASE e (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

Stato di completamento dell'operazione di pre-associazione come definito da un codice di errore all'interno di Winerror.h. Se l'operazione viene completata correttamente, la DLL delle estensioni IHV deve impostare dwWin32Error su ERROR_SUCCESS.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Commenti

La DLL delle estensioni IHV deve seguire queste linee guida quando si chiama la funzione Dot11ExtPreAssociateCompletion .

Se l'operazione di pre-associazione è stata completata correttamente, la DLL delle estensioni IHV deve impostare dwReasonCode su una delle opzioni 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 DLL delle estensioni IHV deve impostare dwWin32Error su ERROR_SUCCESS.
Se l'operazione di pre-associazione è stata completata con un errore, la DLL delle estensioni IHV non deve impostare dwReasonCode su L2_REASON_CODE_SUCCESS. Al contrario, la DLL deve impostare dwReasonCode 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 DLL delle estensioni IHV non deve impostare dwWin32Error su ERROR_SUCCESS. La DLL deve invece impostare dwWin32Error su un codice di errore appropriato definito in Winerror.h
La DLL delle estensioni IHV deve chiamare Dot11ExtPreAssociateCompletion per annullare tutte le operazioni di prea associazione in sospeso ogni volta che vengono chiamate le funzioni Dot11ExtIhvAdapterReset o Dot11ExtIhvDeinitAdapter IHV Handler. In questo caso, la DLL deve impostare il parametro dwWin32Error su ERROR_CANCELLED.

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)

Vedi anche

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Funzioni del gestore IHV native 802.11

Dot11ExtIhvPerformPreAssociate

Condividi tramite