DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES funzione di callback (wlanihv.h)
La DLL delle estensioni IHV chiama la funzione Dot11ExtSetVirtualStationAPProperties per specificare la connessione corrente al profilo IHV.
Sintassi
DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;
DWORD Dot11extSetVirtualStationApProperties(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in] DWORD dwNumProperties,
[in] PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
LPVOID pvReserved
)
{...}
Parametri
[in, optional] hDot11SvcHandle
Handle facoltativo utilizzato dal sistema operativo per fare riferimento alla scheda LAN wireless (WLAN) fisica primaria. Questo valore di handle è stato ricevuto come parametro hDot11SvcHandle tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.
[in, optional] hConnectSession
Handle utilizzato dal sistema operativo per fare riferimento alla sessione di connessione corrente con la rete BSS (Basic Service Set). Questo valore di handle è stato ricevuto come parametro hConnectSession tramite una chiamata precedente a funzione Dot11ExtIhvPerformPreAssociate gestore IHV.
[in] dwNumProperties
Numero di elementi nella matrice di strutture a cui punta il parametro pProperties.
[in] pProperties
Puntatore a una matrice di DOT11EXT_VIRTUAL_STATION_AP_PROPERTY strutture che specificano le proprietà dei punti di accesso (AP) che la stazione virtuale 802.11 sta tentando di ospitare nella sessione di connessione corrente.
pvReserved
Questo parametro è riservato per l'uso dal sistema operativo e deve essere NULL.
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.
Osservazioni
Se la connessione al profilo IHV corrente è un punto di accesso (AP) e la DLL delle estensioni IHV può fornire al sistema operativo le impostazioni usate dall'AP, il sistema operativo può fornire informazioni aggiuntive agli utenti che richiedono il servizio correlato alle API dal sistema operativo.
Se la DLL delle estensioni IHV chiama Dot11ExtSetVirtualStationAPProperties, deve farlo prima di chiamare il funzione Dot11ExtIhvPerformPreAssociate gestore IHV. Se Dot11ExtSetVirtualStationAPProperties non viene chiamato prima del completamento dell'operazione di pre-associazione, il sistema operativo non presuppone la natura del profilo IHV.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 7 e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | wlanihv.h (include Wlanihv.h) |