Funzione WlanRegisterVirtualStationNotification (wlanapi.h)
La funzione WlanRegisterVirtualStationNotification viene usata per registrare e annullare la registrazione delle notifiche in una stazione virtuale.
Sintassi
DWORD WlanRegisterVirtualStationNotification(
[in] HANDLE hClientHandle,
[in] BOOL bRegister,
PVOID pReserved
);
Parametri
[in] hClientHandle
Handle di sessione del client, ottenuto da una chiamata precedente alla funzione WlanOpenHandle .
[in] bRegister
Valore che specifica se ricevere notifiche su una stazione virtuale.
pReserved
Riservato per utilizzi futuri. Questo parametro deve essere NULL.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Un parametro non è corretto. Questo errore viene restituito se si verifica una delle condizioni seguenti:
|
|
Handle non valido. Questo errore viene restituito se l'handle specificato nel parametro hClientHandle non è stato trovato nella tabella handle. |
|
La risorsa non è nello stato corretto per eseguire l'operazione richiesta. Questo errore viene restituito se la rete ospitata wireless è disabilitata da criteri di gruppo in un dominio. |
|
Il servizio non è stato avviato. Questo errore viene restituito se il servizio WLAN AutoConfig non è in esecuzione. |
|
Vari codici di errore RPC e altri. Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Commenti
La funzione WlanRegisterVirtualStationNotification è un'estensione alle API wireless native aggiunte per supportare la rete wireless ospitata in Windows 7 e in Windows Server 2008 R2 con il servizio LAN wireless installato.
Un'applicazione client chiama la funzione WlanRegisterVirtualStationNotification viene usata per registrare e annullare la registrazione delle notifiche nella stazione virtuale.
Qualsiasi registrazione per ricevere notifiche da una stazione virtuale causata da questa funzione viene annullata automaticamente se l'applicazione chiamante chiude l'handle chiamante (chiamando WlanCloseHandle con il parametro hClientHandle ) o se il processo termina.
Per impostazione predefinita, un client dell'applicazione non riceverà notifiche su una stazione virtuale. Per ricevere queste notifiche, un client deve chiamare la funzione WlanRegisterVirtualStationNotification con il parametro bRegister impostato su TRUE e deve anche chiamare la funzione WlanRegisterNotification con il parametro dwNotifSource impostato su origini di notifica da registrare. La registrazione per ricevere notifiche da una stazione virtuale è attiva fino a quando l'applicazione non chiude l'handle client (chiamando WlanCloseHandle con il parametro hClientHandle ), il processo termina o la funzione WlanRegisterVirtualStationNotification viene chiamata con il parametro bRegister impostato su FALSE.
In Windows 7 e versioni successive il sistema operativo installa un dispositivo virtuale se nel computer è presente una scheda wireless con supporto per la rete ospitata. Questo dispositivo virtuale viene in genere visualizzato nella "cartella Connessioni di rete" come "Connessione di rete wireless 2" con un nome di dispositivo "Scheda Miniport WiFi virtuale Microsoft" se il computer ha una singola scheda di rete wireless. Questo dispositivo virtuale viene utilizzato esclusivamente per l'esecuzione di connessioni softAP (Software Access Point) e non è presente nell'elenco restituito dalla funzione WlanEnumInterfaces . La durata di questo dispositivo virtuale è associata alla scheda wireless fisica. Se la scheda wireless fisica è disabilitata, questo dispositivo virtuale verrà rimosso anche. Questa funzionalità è disponibile anche in Windows Server 2008 R2 con il servizio LAN wireless installato.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wlanapi.h (include Wlanapi.h) |
| Libreria | Wlanapi.lib |
| DLL | Wlanapi.dll |
Vedi anche
Informazioni sulla rete ospitata wireless
Uso della rete ospitata wireless e della condivisione della connessione Internet