DOT11EXTIHV_QUERY_UI_REQUEST funzione di callback (wlanihv.h)
Sintassi
DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;
DWORD Dot11extihvQueryUiRequest(
[in, optional] HANDLE hIhvExtAdapter,
[in] DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
[out] PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}
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] connectionPhase
Fase di connessione corrente. Il tipo di dati per questo membro è l'enumerazione DOT11EXT_IHV_CONNECTION_PHASE :
connection_phase_any
Specifica qualsiasi fase di connessione.
connection_phase_initial_connection
Specifica la fase di connessione prima che la DLL di estensioni IHV avvii un'operazione di pre-associazione. Per altre informazioni sull'operazione di pre-associazione, vedere Operazioni di pre-associazione.
connection_phase_post_l3_connection
Specifica la fase di connessione dopo che la DLL delle estensioni IHV completa un'operazione post-associazione. Per altre informazioni sull'operazione post-associazione, vedere Operazioni post-associazione.
[out] ppIhvUIRequest
Indirizzo di un puntatore a una struttura DOT11EXT_IHV_UI_REQUEST . La DLL delle estensioni IHV deve allocare un buffer per la struttura DOT11EXT_IHV_UI_REQUEST chiamando Dot11ExtAllocateBuffer.
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
Quando si chiama Dot11ExtIhvQueryUIRequest , la DLL delle estensioni IHV deve allocare e restituire un buffer formattato come struttura DOT11EXT_IHV_UI_REQUEST . In questa situazione, la DLL deve seguire queste linee guida:
- La DLL delle estensioni IHV deve chiamare Dot11ExtAllocateBuffer per allocare il buffer. Dopo aver restituito la DLL da Dot11ExtIhvQueryUIRequest, il sistema operativo è responsabile della chiamata a Dot11ExtFreeBuffer per liberare il buffer.
-
La DLL delle estensioni IHV formatta la struttura DOT11EXT_IHV_UI_REQUEST per una richiesta dell'interfaccia utente appropriata per la modifica dello stato della connessione.
Ad esempio, se connectionPhase è impostato su connection_phase_initial_connection, la DLL delle estensioni IHV potrebbe impostare i membri della struttura DOT11EXT_IHV_UI_REQUEST per fare riferimento a una pagina dell'interfaccia utente che informa l'utente dell'inizio dell'operazione di connessione.
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) |