Funzione WlanHostedNetworkForceStop (wlanapi.h)

Articolo
03/13/2024

La funzione WlanHostedNetworkForceStop esegue la transizione della rete ospitata wireless al wlan_hosted_network_idle senza associare la richiesta all'handle chiamante dell'applicazione.

Sintassi

DWORD WlanHostedNetworkForceStop(
  [in]            HANDLE                      hClientHandle,
  [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 .

[out, optional] pFailReason

Puntatore facoltativo a un valore che riceve il motivo dell'errore, se la chiamata alla funzione WlanHostedNetworkForceStop 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_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. pvReserved non è NULL.
ERROR_INVALID_STATE	La risorsa non è nello stato corretto per eseguire l'operazione richiesta.
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 WlanHostedNetworkForceStop è 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 WlanHostedNetworkForceStop per forzare l'arresto della rete ospitata e la transizione della rete ospitata wireless al wlan_hosted_network_idle senza associare la richiesta all'handle di chiamata dell'applicazione. Un client chiama in genere la funzione WlanHostedNetworkForceStop per trovare una corrispondenza con una chiamata riuscita precedente alla funzione WlanHostedNetworkForceStart .

La funzione WlanHostedNetworkForceStop potrebbe non riuscire se lo stato della rete ospitata non è wlan_hosted_network_active.

Qualsiasi modifica dello stato della rete ospitata causata da questa funzione non verrà annullata automaticamente se l'applicazione chiamante chiude l'handle chiamante (chiamando WlanCloseHandle con il parametro hClientHandle ) o se il processo termina.

Un'applicazione potrebbe chiamare la funzione WlanHostedNetworkForceStop per arrestare la rete ospitata dopo una precedente chiamata a WlanHostedNetworkForceStart da un utente di sistema con privilegi elevati che ha accettato i requisiti di alimentazione maggiori coinvolti nell'esecuzione della rete ospitata wireless per durate prolungate.

Qualsiasi utente può chiamare la funzione WlanHostedNetworkForceStop per forzare l'arresto della rete ospitata. Tuttavia, la possibilità di abilitare la rete ospitata wireless può 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