Funzione WlanHostedNetworkInitSettings (wlanapi.h)

Articolo
03/04/2024

La funzione WlanHostedNetworkInitSettings configura e mantiene in modo permanente l'archiviazione delle impostazioni di connessione di rete (SSID e numero massimo di peer, ad esempio) nella rete ospitata wireless se queste impostazioni non sono già configurate.

Sintassi

DWORD WlanHostedNetworkInitSettings(
  [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 WlanHostedNetworkInitSettings 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 viene ERROR_SUCCESS.

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

Codice restituito	Descrizione
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_PARAMETER	Un parametro non è corretto. Questo errore viene restituito se si verifica una delle condizioni seguenti: hClientHandle è NULL. pvReserved non è NULL.
ERROR_INVALID_STATE	La risorsa non è nello stato corretto per eseguire l'operazione richiesta.
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 WlanHostedNetworkInitSettings è un'estensione per le 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 WlanHostedNetworkInitSettings per configurare e rendere persistenti l'archiviazione delle impostazioni di connessione di rete (SSID e numero massimo di peer, ad esempio) nella rete ospitata wireless, se le impostazioni di connessione non sono già configurate. Se le impostazioni di rete nelle impostazioni di rete ospitata wireless sono già configurate (la funzione WlanHostedNetworkQueryProperty non restituisce ERROR_BAD_CONFIGURATION per il profilo della stazione o le impostazioni di connessione), questa chiamata di funzione restituisce ERROR_SUCCESS senza modificare la configurazione delle impostazioni di connessione di rete.

Un'applicazione client deve sempre chiamare la funzione WlanHostedNetworkInitSettings prima di usare altre funzionalità di rete ospitata nel computer locale. Questa funzione inizializza le impostazioni necessarie quando la rete ospitata wireless viene usata per la prima volta in un computer locale. La funzione WlanHostedNetworkInitSettings non modifica alcuna configurazione se la configurazione è già stata resa persistente. È quindi possibile chiamare la funzione WlanHostedNetworkInitSettings se la configurazione è già stata salvata in modo permanente. È consigliabile che le applicazioni che usano Hosted Network chiamino la funzione WlanHostedNetworkInitSettings prima di usare altre funzioni di rete ospitata.

La funzione WlanHostedNetworkInitSettings calcola un SSID casuale e leggibile dal nome host e calcola una chiave primaria casuale. Questa funzione usa anche un valore per il numero massimo di peer consentiti che per impostazione predefinita è 100. Se un'applicazione vuole usare un SSID diverso o un numero massimo di peer diverso, l'applicazione deve chiamare la funzione WlanHostedNetworkSetProperty per impostare in modo specifico queste proprietà utilizzate dalla rete ospitata wireless.

Qualsiasi modifica dello stato della rete ospitata causata da questa funzione non verrà annullata automaticamente se l'applicazione chiamante chiude l'handle chiamante (chiamando WlanCloseHandle con il parametro hClientHandle ) o se il processo termina.

Qualsiasi utente può chiamare la funzione WlanHostedNetworkInitSettings per configurare e rendere persistenti le impostazioni di connessione di rete di archiviazione nella rete ospitata. Se la rete ospitata wireless è già stata configurata, questa funzione non esegue alcuna operazione e restituisce ERROR_SUCCESS.

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 "Rete Connections cartella" come "Connessione di rete wireless 2" con un nome di dispositivo "Scheda Miniport WiFi virtuale Microsoft" se il computer dispone di 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

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