Funzione WlanConnect (wlanapi.h)

Articolo
08/28/2023

La funzione WlanConnect tenta di connettersi a una rete specifica.

Sintassi

DWORD WlanConnect(
  [in] HANDLE                            hClientHandle,
  [in] const GUID                        *pInterfaceGuid,
  [in] const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
       PVOID                             pReserved
);

Parametri

[in] hClientHandle

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

[in] pInterfaceGuid

GUID dell'interfaccia da usare per la connessione.

[in] pConnectionParameters

Puntatore a una struttura WLAN_CONNECTION_PARAMETERS che specifica il tipo di connessione, la modalità, il profilo di rete, SSID che identifica la rete e altri parametri.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Esistono alcuni vincoli per i membri WLAN_CONNECTION_PARAMETERS . Ciò significa che le strutture valide per Windows Server 2008 e Windows Vista potrebbero non essere valide per Windows XP con SP3 o API LAN wireless per Windows XP con SP2. Per un elenco di vincoli, vedere WLAN_CONNECTION_PARAMETERS.

pReserved

Riservato per utilizzi futuri. Deve essere impostato su 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_PARAMETER	Si è verificata una delle condizioni seguenti: hClientHandle è NULL o non valido. pInterfaceGuid è NULL. pConnectionParameters è NULL. Il membro dwFlags della struttura a cui punta pConnectionParameters non è impostato su uno dei valori specificati nella pagina WLAN_CONNECTION_PARAMETERS . Il membro wlanConnectionMode della struttura a cui punta pConnectionParameters è impostato su wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure e il membro pDot11Ssid della stessa struttura è NULL. Il membro wlanConnectionMode della struttura a cui punta pConnectionParameters è impostato su wlan_connection_mode_discovery_secure o wlan_connection_mode_discovery_unsecure e il membro dot11BssType della stessa struttura è impostato su dot11_BSS_type_any. Il membro wlanConnectionMode della struttura a cui punta pConnectionParameters è impostato su wlan_connection_mode_profile e il membro strProfile della stessa struttura è NULL o la lunghezza del profilo supera WLAN_MAX_NAME_LENGTH. Il membro wlanConnectionMode della struttura a cui punta pConnectionParameters è impostato su wlan_connection_mode_profile e il membro strProfile della stessa struttura è NULL o la lunghezza del profilo è zero. Il membro wlanConnectionMode della struttura a cui punta pConnectionParameters è impostato su wlan_connection_mode_invalid o wlan_connection_mode_auto. Il membro dot11BssType della struttura a cui punta pConnectionParameters è impostato su dot11_BSS_type_infrastructure e il membro dwFlags della stessa struttura è impostato su WLAN_CONNECTION_ADHOC_JOIN_ONLY. Il membro dot11BssType della struttura a cui punta pConnectionParameters è impostato su dot11_BSS_type_independent e il membro dwFlags della stessa struttura è impostato su WLAN_CONNECTION_HIDDEN_NETWORK. Il membro dwFlags della struttura a cui punta pConnectionParameters è impostato su WLAN_CONNECTION_IGNORE_PRIVACY_BIT e il membro wlanConnectionMode della stessa struttura non è impostato su wlan_connection_mode_temporary_profile o il membro dot11BssType della stessa struttura è impostato su dot11_BSS_type_independent.
ERROR_INVALID_HANDLE	L'handle hClientHandle non è stato trovato nella tabella handle.
RPC_STATUS	Vari codici di errore.
ERROR_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti.

Commenti

La funzione WlanConnect restituisce immediatamente. Per ricevere una notifica quando viene stabilita una connessione o quando non verranno tentate altre connessioni, un client deve registrarsi per le notifiche chiamando WlanRegisterNotification.

Il membro strProfile della struttura WLAN_CONNECTION_PARAMETERS a cui punta pConnectionParameters specifica il profilo da usare per la connessione. Se questo profilo è un profilo utente, il chiamante WlanConnect deve avere accesso all'esecuzione nel profilo. In caso contrario, la chiamata WlanConnect avrà esito negativo con il valore restituito ERROR_ACCESS_DENIED. Le autorizzazioni per un profilo utente vengono stabilite quando il profilo viene creato o salvato usando WlanSetProfile o WlanSaveTemporaryProfile.

Per eseguire un'operazione di connessione nella riga di comando, usare il comando netsh wlan connect . Per altre informazioni, vedere Netsh Commands for Wireless Local Area Network (wlan).For more information, see Netsh Commands for Wireless Local Area Network (wlan).

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: È possibile utilizzare WlanConnect solo per connettersi alle reti nell'elenco di rete preferito. Per aggiungere una rete all'elenco di rete preferito, chiamare WlanSetProfile.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wlanapi.h (include Wlanapi.h)
Libreria	Wlanapi.lib
DLL	Wlanapi.dll
Componente ridistribuibile	API LAN wireless per Windows XP con SP2

Vedi anche

WLAN_CONNECTION_PARAMETERS

WlanDisconnect

Condividi tramite