Funzione WlanDisconnect (wlanapi.h)

Articolo
03/15/2023

La funzione WlanDisconnect disconnette un'interfaccia dalla rete corrente.

Sintassi

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

Parametri

[in] hClientHandle

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

[in] pInterfaceGuid

GUID dell'interfaccia da disconnettere.

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	hClientHandle è NULL o non valido, pInterfaceGuid è NULL o pReserved non è NULL.
ERROR_INVALID_HANDLE	L'handle hClientHandle non è stato trovato nella tabella handle.
RPC_STATUS	Vari codici di errore.
ERROR_NOT_ENOUGH_MEMORY	Impossibile allocare memoria per i risultati della query.
ERROR_ACCESS_DENIED	Il chiamante non dispone di autorizzazioni sufficienti.

Commenti

Quando la connessione è stata stabilita tramite WlanConnect, un profilo è stato specificato dal membro strProfile della struttura WLAN_CONNECTION_PARAMETERS a cui punta pConnectionParameters. Se il profilo è un profilo all-user, il chiamante WlanDisconnect deve avere accesso all'esecuzione nel profilo. In caso contrario, la chiamata WlanDisconnect 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 disconnessione nella riga di comando, usare il comando netsh wlan disconnect . 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 l'API LAN wireless per Windows XP con SP2: WlanDisconnect ha l'effetto collaterale di modificare il profilo associato alla rete disconnessa. Un profilo di rete diventa un profilo su richiesta dopo una chiamata WlanDisconnect . Il servizio Wireless Zero Configuration non si connetterà automaticamente a una rete con un profilo su richiesta quando la rete è in intervallo. Non chiamare WlanDisconnect prima di chiamare WlanConnect , a meno che non si voglia modificare un profilo su richiesta. Quando si chiama WlanConnect per stabilire una connessione di rete, qualsiasi connessione di rete esistente viene eliminata automaticamente.

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

WlanConnect

Condividi tramite