DOT11EXT_PRE_ASSOCIATE_COMPLETION funzione di callback (wlanihv.h)

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