DOT11EXT_POST_ASSOCIATE_COMPLETION funzione di callback (wlanihv.h)

Articolo
03/05/2024

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.

La DLL di estensioni IHV chiama la funzione Dot11ExtPostAssociateCompletion per completare in modo asincrono un'operazione di post associazione avviata tramite una chiamata all'oggetto Dot11ExtIhvPerformPostAssociate Funzione gestore IHV.

Sintassi

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Parametri

[in, optional] hDot11SvcHandle

Handle usato dal sistema operativo 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 dell'identificatore di sessione di sicurezza (ID) restituito tramite una chiamata precedente all'oggetto Dot11ExtIhvPerformPostAssociate Funzione gestore IHV.

[in, optional] pPeer

Indirizzo MAC (Media Access Control) del punto di accesso (AP) con cui la DLL di estensioni IHV ha eseguito un'operazione di sicurezza. Questo parametro viene formattato come struttura DOT11_MAC_ADDRESS .

Nota Per Windows Vista, la DLL delle estensioni IHV supporta solo le reti BSS (Infrastructure Basic Service Set).

[in] dwReasonCode

Valore che fornisce informazioni aggiuntive per lo stato di completamento dell'operazione post-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 post-associazione tramite il parametro dwWin32Error . In genere, la DLL 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 post-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 chiama la funzione Dot11ExtPostAssociateCompletion per eseguire una delle operazioni seguenti:

Completare l'operazione post-associazione avviata da una chiamata all'oggetto Dot11ExtIhvPerformPostAssociate Funzione gestore IHV.
Dopo aver completato l'operazione post-associazione, indicare una modifica nello stato della porta per la sessione di sicurezza a cui fa riferimento il parametro hSecuritySessionID .
Ad esempio, se lo stato di autorizzazione della porta viene modificato, la DLL delle estensioni IHV può inviare una notifica al sistema operativo chiamando Dot11ExtPostAssociateCompletion.

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

Se l'operazione post-associazione è stata completata correttamente, la DLL delle estensioni IHV deve impostare dwReasonCode su uno dei seguenti elementi:
- L2_REASON_CODE_SUCCESS.
- Valore definito dall'IHV nell'intervallo compreso tra L2_REASON_CODE_IHV_BASE e (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
In questa situazione, la DLL delle estensioni IHV deve impostare dwWin32Error su ERROR_SUCCESS.
Nota Se la DLL di estensioni IHV imposta dwWin32Error su ERROR_SUCCESS, il sistema operativo presuppone che lo stato della porta per la sessione di sicurezza sia in uno stato autorizzato. Dopo che la porta è in uno stato autorizzato, il sistema operativo consente l'invio di tutti i pacchetti di dati tramite l'adattatore WLAN.
Se l'operazione post-associazione è stata completata con un errore, la DLL delle estensioni IHV non deve impostare dwReasonCode su L2_REASON_CODE_SUCCESS. Invece, la DLL deve impostare dwReasonCode su uno dei seguenti:
- Valore di errore L2_REASON_CODE_xxxx appropriato.
- Valore definito dall'IHV nell'intervallo compreso tra L2_REASON_CODE_IHV_BASE e (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
In questa situazione, 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.
Nota Se la DLL delle estensioni IHV non imposta dwWin32Error su ERROR_SUCCESS, il sistema operativo presuppone che lo stato della porta per la sessione di sicurezza sia in uno stato non autorizzato. Dopo che la porta si trova in uno stato non autorizzato, il sistema operativo consente pacchetti di sicurezza, inclusi i pacchetti inviati tramite la funzione Dot11ExtSendPacket IHV Extensions, da inviare tramite l'adattatore WLAN.
La DLL delle estensioni IHV deve chiamare Dot11ExtPostAssociateCompletion per annullare tutte le operazioni post-associazione in sospeso ogni volta che vengono chiamate le funzioni Dot11ExtIhvAdapterReset o Dot11ExtIhvDeinitAdapter IHV Handler. In questa situazione, la DLL deve impostare il parametro dwStatus 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)