DOT11EXTIHV_PERFORM_POST_ASSOCIATE funzione di callback (wlanihv.h)

Importante L'interfaccia LAN wireless nativa 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 Dot11ExtIhvPerformPostAssociate per richiedere che la DLL di estensioni IHV avvia un'operazione post-associazione con la rete BSS (Basic Service Set).

Sintassi

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

Parametri

[in, optional] hIhvExtAdapter

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

[in, optional] hSecuritySessionID

Handle della sessione di sicurezza. La DLL delle estensioni IHV deve usare questo valore di handle quando chiama Dot11ExtPostAssociateCompletion per completare in modo asincrono l'operazione post-associazione.

[in] pPortState

Puntatore a una struttura DOT11_PORT_STATE , che specifica lo stato corrente della sessione di sicurezza.

[in] uDot11AssocParamsBytes

Lunghezza, in byte, dei dati a cui si fa riferimento tramite il parametro pDot11AssocParams .

[in] pDot11AssocParams

Puntatore a DOT11_ASSOCIATION_COMPLETION_PARAMETERS struttura, che specifica il risultato dell'operazione di associazione completata dall'adattatore WLAN. Il driver miniport nativo 802.11, che gestisce la scheda WLAN, include una struttura DOT11_ASSOCIATION_COMPLETION_PARAMETERS quando rende un supporto specifico NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indicazione.

Per altre informazioni sull'operazione di associazione, vedere Operazioni di associazione.

Valore restituito

Se la DLL dell'estensione IHV può avviare l'operazione post-associazione, deve completare l'operazione in modo asincrono. In questa situazione la funzione restituisce ERROR_SUCCESS.

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

Commenti

Il sistema operativo chiama la funzione Dot11ExtIhvPerformPostAssociate per avviare un'operazione post-associazione con la DLL delle estensioni IHV. Il sistema operativo avvia questa operazione dopo che la scheda WLAN completa un'operazione di associazione con un punto di accesso (AP) in una rete BSS (Infrastructure Basic Service Set).

Nota Per Windows Vista, la DLL delle estensioni IHV supporta solo le reti BSS (Infrastructure Basic Service Set).
 
Per altre informazioni sull'operazione di associazione, vedere Operazioni di associazione.

L'operazione post-associazione deve essere completata in modo asincrono dalla chiamata a Dot11ExtIhvPerformPostAssociate. Al termine dell'operazione post-associazione, la DLL deve chiamare Dot11ExtPostAssociateCompletion.

Se la DLL di estensioni IHV può avviare l'operazione post-associazione, la funzione Dot11ExtIhvPerformPostAssociate deve restituire ERROR_SUCCESS e completare l'operazione in modo asincrono.

Per altre informazioni sull'operazione post-associazione, vedere Operazioni post-associazione.

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

Vedi anche

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION