Funzione WlanHostedNetworkQueryStatus (wlanapi.h)

Articolo
03/04/2024

La funzione WlanHostedNetworkQueryStatus esegue una query sullo stato corrente della rete ospitata wireless.

Sintassi

DWORD WlanHostedNetworkQueryStatus(
  [in]  HANDLE                      hClientHandle,
  [out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
        PVOID                       pvReserved
);

Parametri

[in] hClientHandle

Handle di sessione del client, restituito da una chiamata precedente alla funzione WlanOpenHandle .

[out] ppWlanHostedNetworkStatus

In input, questo parametro deve essere NULL.

In output, questo parametro riceve un puntatore allo stato corrente della rete ospitata wireless, se la chiamata alla funzione WlanHostedNetworkQueryStatus ha esito positivo. Lo stato corrente viene restituito in una struttura WLAN_HOSTED_NETWORK_STATUS .

pvReserved

Riservato per utilizzi futuri. Questo parametro deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.

Codice restituito	Descrizione
ERROR_INVALID_HANDLE	Un handle non è valido. Questo errore viene restituito se l'handle specificato nel parametro hClientHandle non è stato trovato nella tabella handle.
ERROR_INVALID_PARAMETER	Un parametro non è corretto. Questo errore viene restituito se si verificano una delle condizioni seguenti: hClientHandle è NULL. ppWlanHostedNetworkStatus è NULL. pvReserved non è NULL.
ERROR_INVALID_STATE	La risorsa non è nello stato corretto per eseguire l'operazione richiesta. Ciò può verificarsi se la rete ospitata wireless è stata nel processo di arresto.
ERROR_SERVICE_NOT_ACTIVE	Il servizio non è stato avviato. Questo errore viene restituito se il servizio AutoConfig WLAN non è in esecuzione.
Altri	Vari codici di errore RPC e altri codici di errore. Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

La funzione WlanHostedNetworkQueryStatus è un'estensione alle API wireless native aggiunte per supportare la rete ospitata wireless in Windows 7 e in Windows Server 2008 R2 con il servizio LAN wireless installato.

Un'applicazione client chiama la funzione WlanHostedNetworkQueryStatus per eseguire query sullo stato corrente della rete ospitata wireless. Questa funzione non modifica lo stato della rete ospitata wireless.

Se la funzione ha esito positivo, il parametro ppWlanHostedNetworkStatus punta a una struttura WLAN_HOSTED_NETWORK_STATUS con lo stato corrente. La memoria usata per la struttura WLAN_HOSTED_NETWORK_STATUS restituita deve essere liberata dopo l'uso chiamando la funzione WlanFreeMemory .

Qualsiasi utente può chiamare la funzione WlanHostedNetworkQueryStatus per eseguire query sulla rete ospitata. Tuttavia, la possibilità di abilitare la rete ospitata wireless può essere limitata dai criteri di gruppo in un dominio.

In Windows 7 e versioni successive il sistema operativo installa un dispositivo virtuale se una scheda wireless con supporto per la rete ospitata è presente nel computer. Questo dispositivo virtuale viene normalmente visualizzato nella "Rete Connections Cartella" come "Connessione di rete wireless 2" con un nome dispositivo di "Scheda Miniport WiFi virtuale Microsoft" se il computer ha una singola scheda di rete wireless. Questo dispositivo virtuale viene usato esclusivamente per eseguire 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 l'adattatore wireless fisico è disabilitato, questo dispositivo virtuale verrà rimosso anche. Questa funzionalità è disponibile anche in Windows Server 2008 R2 con il servizio LAN wireless installato.

Requisiti

Requisito	Valore
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