DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES funzione di callback (wlanihv.h)

Articolo
08/08/2023

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 delle estensioni IHV chiama la funzione Dot11ExtSetVirtualStationAPProperties per specificare la connessione corrente del 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 usato dal sistema operativo per fare riferimento all'adattatore LAN wireless (WLAN) fisico primario. Questo valore di handle è stato ricevuto come parametro hDot11SvcHandle tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in, optional] hConnectSession

Handle usato 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 all'oggetto Dot11ExtIhvPerformPreAssociate Funzione 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 (APS) 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.

Commenti

Se la connessione del 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 Dot11ExtIhvPerformPreAssociate Funzione 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.

Requisiti

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)

Vedi anche

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY