Funzione WlanHostedNetworkQueryProperty (wlanapi.h)

Articolo
03/13/2024

La funzione WlanHostedNetworkQueryProperty esegue una query sulle proprietà statiche correnti della rete ospitata wireless.

Sintassi

DWORD WlanHostedNetworkQueryProperty(
  [in]  HANDLE                     hClientHandle,
  [in]  WLAN_HOSTED_NETWORK_OPCODE OpCode,
  [out] PDWORD                     pdwDataSize,
  [out] PVOID                      *ppvData,
  [out] PWLAN_OPCODE_VALUE_TYPE    pWlanOpcodeValueType,
        PVOID                      pvReserved
);

Parametri

[in] hClientHandle

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

[in] OpCode

Identificatore della proprietà da eseguire una query. Questo identificatore può essere uno dei valori dell'enumerazione WLAN_HOSTED_NETWORK_OPCODE definito nel file di intestazione Wlanapi.h .

[out] pdwDataSize

Puntatore a un valore che specifica le dimensioni, in byte, del buffer restituito nel parametro ppvData , se la chiamata alla funzione WlanHostedNetworkQueryProperty ha esito positivo.

[out] ppvData

In input, questo parametro deve essere NULL.

In output, questo parametro riceve un puntatore a un buffer restituito con la proprietà statica richiesta, se la chiamata alla funzione WlanHostedNetworkQueryProperty riesce. Il tipo di dati associato a questo buffer dipende dal valore del parametro OpCode .

[out] pWlanOpcodeValueType

Puntatore a un valore che riceve il tipo di valore della proprietà Rete ospitata wireless, se la chiamata alla funzione WlanHostedNetworkQueryProperty ha esito positivo. Il valore restituito è un tipo enumerato nell'enumerazione WLAN_OPCODE_VALUE_TYPE definita 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_BAD_CONFIGURATION	I dati di configurazione per la rete ospitata wireless non sono configurati. Questo errore viene restituito se l'applicazione chiama la funzione WlanHostedNetworkQueryProperty con il parametro OpCode impostato su wlan_hosted_network_opcode_station_profile o wlan_hosted_network_opcode_connection_settings prima che un SSID sia configurato nella rete ospitata wireless.
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. OpCode non è uno dei valori enumerati definiti nella WLAN_HOSTED_NETWORK_OPCODE. pdwDataSize è NULL. ppvData è NULL. pWlanOpcodeValueType è 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_OUTOFMEMORY	Memoria disponibile insufficiente per completare l'operazione.
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 WlanHostedNetworkQueryProperty è 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 WlanHostedNetworkQueryProperty per eseguire query sulle proprietà statiche correnti della rete ospitata wireless. Questa funzione non modifica lo stato o le proprietà della rete ospitata wireless.

Se la funzione ha esito positivo, il parametro ppvData punta a un buffer contenente la proprietà richiesta. Le dimensioni di questo buffer vengono restituite in un puntatore restituito nel parametro pwdDataSize . Il WLAN_OPCODE_VALUE_TYPE viene restituito in un puntatore restituito nel parametro pWlanOpcodeValueType . La memoria usata per il buffer nel parametro ppvData restituita deve essere rilasciata chiamando la funzione WlanFreeMemory dopo che il buffer non è più necessario.

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

OpCode	Descrizione
wlan_hosted_network_opcode_connection_settings	Viene restituito un puntatore a una struttura WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS .
wlan_hosted_network_opcode_security_settings	Viene restituito un puntatore a una struttura WLAN_HOSTED_NETWORK_SECURITY_SETTINGS .
wlan_hosted_network_opcode_station_profile	Viene restituito un profilo PWSTR che contiene un profilo WLAN XML per la connessione alla rete ospitata wireless.
wlan_hosted_network_opcode_enable	PBOOL che indica se la rete ospitata wireless è abilitata viene restituita.

Se la funzione WlanHostedNetworkQueryProperty viene passata a uno dei valori seguenti nel parametro OpCode prima che un SSID sia configurato nella rete ospitata wireless, la funzione avrà esito negativo con ERROR_BAD_CONFIGURATION:

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

Qualsiasi utente può chiamare la funzione WlanHostedNetworkQueryProperty per eseguire query sulle proprietà di Rete ospitata.

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