Funzione WlanHostedNetworkSetProperty (wlanapi.h)

Articolo
08/28/2023

La funzione WlanHostedNetworkSetProperty imposta le proprietà statiche della rete ospitata wireless.

Sintassi

DWORD WlanHostedNetworkSetProperty(
  [in]            HANDLE                      hClientHandle,
  [in]            WLAN_HOSTED_NETWORK_OPCODE  OpCode,
  [in]            DWORD                       dwDataSize,
  [in]            PVOID                       pvData,
  [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 .

[in] OpCode

Identificatore della proprietà da impostare. Questo identificatore può essere solo i valori seguenti nell'enumerazione WLAN_HOSTED_NETWORK_OPCODE definita nel file di intestazione Wlanapi.h :

wlan_hosted_network_opcode_connection_settings

Impostazioni di connessione di rete ospitata.

wlan_hosted_network_opcode_enable

Flag abilitata per la rete ospitata.

[in] dwDataSize

Valore che specifica le dimensioni, in byte, del buffer a cui punta il parametro pvData .

[in] pvData

Puntatore a un buffer con la proprietà statica da impostare. Il tipo di dati associato a questo buffer dipende dal valore del parametro OpCode .

[out, optional] pFailReason

Puntatore facoltativo a un valore che riceve il motivo dell'errore, se la chiamata alla funzione WlanHostedNetworkSetProperty 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_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti. Questo errore viene restituito anche se il parametro OpCode è stato wlan_hosted_network_opcode_enable e la rete ospitata wireless è disabilitata da criteri di gruppo in un dominio.
ERROR_BAD_PROFILE	Il profilo di connessione di rete utilizzato dalla rete ospitata wireless è danneggiato.
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. OpCode non è uno dei valori enumerati definiti nel WLAN_HOSTED_NETWORK_OPCODE. dwDataSize è zero. pvData è NULL. pvData non punta a una proprietà statica ben formata. 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 è in corso di arresto.
ERROR_NOT_SUPPORTED	La richiesta non è supportata. Questo errore viene restituito se l'applicazione chiama la funzione WlanHostedNetworkSetProperty con il parametro OpCode impostato su wlan_hosted_network_opcode_station_profile o wlan_hosted_network_opcode_security_settings.
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 WlanHostedNetworkSetProperty è 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 WlanHostedNetworkSetProperty per impostare le proprietà statiche correnti della rete ospitata wireless. Qualsiasi modifica della proprietà Hosted Network causata da questa funzione non viene annullata automaticamente se l'applicazione chiamante chiude l'handle chiamante (chiamando WlanCloseHandle con il parametro hClientHandle ) o se il processo termina.

Il tipo di dati associato al buffer a cui punta il parametro pvData dipende dal valore del parametro OpCode come indicato di seguito:

OpCode	Descrizione
wlan_hosted_network_opcode_connection_settings	Un puntatore a una struttura WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS viene passato nel parametro pvData .
wlan_hosted_network_opcode_enable	Un puntatore a BOOL viene passato nel parametro pvData .

Se la funzione WlanHostedNetworkSetProperty viene chiamata con il parametro OpCode impostato su wlan_hosted_network_opcode_enable, l'utente deve disporre del privilegio associato appropriato. Le autorizzazioni vengono archiviate in un elenco di controllo di accesso discrezionale (DACL) associato a un WLAN_SECURABLE_OBJECT. Per chiamare la funzione WlanHostedNetworkSetProperty con il parametro OpCode di wlan_hosted_network_opcode_enable, il token di accesso client del chiamante deve disporre di privilegi elevati esposti dall'enumerazione seguente in WLAN_SECURABLE_OBJECT:

wlan_secure_hosted_network_elevated_access

Se la funzione WlanHostedNetworkSetProperty viene passata a uno dei valori seguenti nel parametro OpCode , la funzione avrà esito negativo con ERROR_NOT_SUPPORTED:

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

Per avere esito positivo, la funzione WlanHostedNetworkSetProperty deve rendere persistenti le nuove impostazioni che richiedono la transizione dello stato Rete ospitata a wlan_hosted_network_idle se è attualmente in esecuzione (wlan_hosted_network_active).

Qualsiasi utente può chiamare questa funzione per impostare le proprietà della rete ospitata. Tuttavia, per impostare il flag di wlan_hosted_network_opcode_enable sono necessari privilegi elevati. La possibilità di abilitare la rete ospitata wireless può anche essere limitata da criteri di gruppo in un dominio.

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