DOT11EXTIHV_PERFORM_POST_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 Dot11ExtIhvPerformPostAssociate per richiedere che la DLL delle estensioni IHV avvii 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 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] 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 di post-associazione.

[in] pPortState

Puntatore a una struttura DOT11_PORT_STATE, che specifica lo stato della porta 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 un 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 l'adattatore 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 Association Operations.

Valore restituito

Se la DLL dell'estensione IHV può avviare l'operazione post-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 post-associazione, restituisce un codice di errore definito in Winerror.h.

Osservazioni

Il sistema operativo chiama la funzione Dot11ExtIhvPerformPostAssociate per avviare un'operazione di 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 Association Operations.

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

Se la DLL delle estensioni IHV può avviare l'operazione di 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.

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

Vedere anche

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION

Condividi tramite