Funzione WlanHostedNetworkForceStart (wlanapi.h)

Articolo
08/28/2023

La funzione WlanHostedNetworkForceStart passa la rete ospitata wireless allo stato wlan_hosted_network_active senza associare la richiesta all'handle di chiamata dell'applicazione.

Sintassi

DWORD WlanHostedNetworkForceStart(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Parametri

[in] hClientHandle

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

[out, optional] pFailReason

Puntatore facoltativo a un valore che riceve il motivo dell'errore se la chiamata alla funzione WlanHostedNetworkForceStart ha esito negativo. I valori possibili per il motivo dell'errore provengono dal tipo di enumerazione WLAN_HOSTED_NETWORK_REASON definito nel file di intestazione Wlanapi.h .

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_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti.
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. pvReserved non è NULL.
ERROR_INVALID_STATE	La risorsa non è nello stato corretto per eseguire l'operazione richiesta. Questo errore viene restituito se la rete ospitata wireless è disabilitata dai criteri di gruppo in un dominio.
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 WlanHostedNetworkForceStart è 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 WlanHostedNetworkForceStart per forzare l'inizio della rete ospitata wireless passando la rete ospitata wireless allo stato wlan_hosted_network_active senza associare la richiesta all'handle di chiamata dell'applicazione. Una chiamata riuscita alla funzione WlanHostedNetworkForceStart deve essere completata da una chiamata alla funzione WlanHostedNetworkForceStop . Qualsiasi modifica dello stato della rete ospitata causata da questa funzione non verrà annullata automaticamente se l'applicazione chiamante chiude il relativo handle chiamante (chiamando WlanCloseHandle con il parametro hClientHandle ) o se il processo termina.

Il costo della chiamata alla funzione WlanHostedNetworkForceStart tramite la chiamata di WlanHostedNetworkStartUsing è il privilegio associato richiesto. Un'applicazione potrebbe chiamare la funzione WlanHostedNetworkForceStart dopo aver verificato che un utente del sistema con privilegi elevati accetti i requisiti di alimentazione più elevati coinvolti nell'esecuzione della rete ospitata wireless per durate estese.

La funzione WlanHostedNetworkForceStart potrebbe non riuscire se lo stato della rete ospitata è wlan_hosted_network_unavailable o il chiamante non dispone di privilegi sufficienti.

Questa funzione per forzare l'inizio della rete ospitata può essere chiamata solo se l'utente ha il privilegio associato appropriato. Le autorizzazioni vengono archiviate in un elenco di controllo di accesso discrezionale associato a un WLAN_SECURABLE_OBJECT. Per chiamare WlanHostedNetworkForceStart, il token di accesso client del chiamante deve avere privilegi elevati esposti dall'enumerazione seguente in WLAN_SECURABLE_OBJECT:

wlan_secure_hosted_network_elevated_access

La possibilità di abilitare la rete ospitata wireless può essere limitata anche 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 "cartella Connessioni di rete" 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


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