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
ERROR_INVALID_PARAMETER	Un parametro non è corretto. Questo errore viene restituito se si verifica una delle condizioni seguenti: hClientHandle è NULL. pvReserved non è NULL.
ERROR_INVALID_HANDLE	Handle non valido. Questo errore viene restituito se l'handle specificato nel parametro hClientHandle non è stato trovato nella tabella handle.
ERROR_INVALID_STATE	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.
ERROR_SERVICE_NOT_ACTIVE	Il servizio non è stato avviato. Questo errore viene restituito se il servizio WLAN AutoConfig non è in esecuzione.
Altri	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

WlanCloseHandle

WlanRegisterNotification