Condividi tramite

Funzione WlanDisconnect (wlanapi.h)

  • Articolo

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