Condividi tramite

WiFiOnDemandHotspotNetwork Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Devices.WiFi
Modifica

Nota

Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite.

Importante

Questa API sarà interessata dalle modifiche imminenti al comportamento del sistema operativo, previsto per l'autunno 2024. Per altre informazioni, vedere Modifiche al comportamento dell'API per Wi-Fi l'accesso e la posizione.

Rappresenta un dispositivo che supporta hotspot su richiesta. L'app registra il dispositivo con il sistema operativo, in cui l'app può abilitare in remoto l'hotspot per dispositivi mobili. Aggiornando le proprietà in questo oggetto, l'app può segnalare al sistema operativo di aggiornare l'interfaccia utente. L'oggetto viene chiaveto su un identificatore univoco globale scelto dal chiamante (GUID) destinato a identificare il dispositivo (proprietà Id ).

Nota

Se si vuole usare questa API in un'app UWP e pubblicare l'app in Microsoft Store, sarà necessario richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre informazioni, vedere Funzionalità personalizzate.

La funzionalità Di rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari di hotspot end-to-Wi-Fi end tra un dispositivo hardware compatibile con tethering e un PC Windows.

public ref class WiFiOnDemandHotspotNetwork sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WiFiOnDemandHotspotNetwork final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WiFiOnDemandHotspotNetwork
Public NotInheritable Class WiFiOnDemandHotspotNetwork
Ereditarietà
Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 11 Insider Preview (è stato introdotto in 10.0.23504.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v15.0)
Funzionalità dell'app
onDemandHotspotControl

Esempio

Esempio hotspot on demand

Commenti

L'hotspot su richiesta è la funzionalità di Windows che consente a un dispositivo client Windows di visualizzare e abilitare in remoto il punto di accesso hotspot/internet sharing mobile in un dispositivo Windows host (un PC o un telefono) e connettersi a esso. Ciò consente al dispositivo client di condividere la connessione Internet del dispositivo host. Questa funzionalità viene esposta all'utente inserendo una rete Wi-Fi nell'elenco di rete del client quando l'utente apre le impostazioni rapide Wi-Fi o Wi-Fi reti disponibili (Windows 11).

L'app è responsabile di determinare come comunicare con l'hotspot per ottenere i metadati, all'esterno di questa API.

Proprietà

Id

Nota

Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite.

Importante

Questa API sarà interessata dalle modifiche imminenti al comportamento del sistema operativo, previsto per l'autunno 2024. Per altre informazioni, vedere Modifiche al comportamento dell'API per Wi-Fi l'accesso e la posizione.

Identificatore univoco globale (GUID) scelto dal chiamante che deve identificare l'hotspot.

Nota

Se vuoi usare questa API in un'app UWP e pubblica la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre info, vedi Funzionalità personalizzate.

La funzionalità Rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari hotspot Wi-Fi end-to-end tra un dispositivo hardware con supporto per il tethering e un PC Windows.

Metodi

GetOrCreateById(Guid)

Nota

Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite.

Importante

Questa API sarà interessata dalle modifiche imminenti al comportamento del sistema operativo, previsto per l'autunno 2024. Per altre informazioni, vedere Modifiche al comportamento dell'API per Wi-Fi l'accesso e la posizione.

Se il sistema operativo è già configurato con un hotspot dall'app chiamante, GetOrCreateById recupera l'oggetto WiFiOnDemandHotspotNetwork che corrisponde al networkId specificato. In caso contrario, il metodo crea una nuova rete per tale ID.

Nota

Se vuoi usare questa API in un'app UWP e pubblica la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre info, vedi Funzionalità personalizzate.

La funzionalità Rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari hotspot Wi-Fi end-to-end tra un dispositivo hardware con supporto per il tethering e un PC Windows.
GetProperties()

Nota

Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite.

Importante

Questa API sarà interessata dalle modifiche imminenti al comportamento del sistema operativo, previsto per l'autunno 2024. Per altre informazioni, vedere Modifiche al comportamento dell'API per Wi-Fi l'accesso e la posizione.

Recupera da un oggetto WiFiOnDemandHotspotNetwork varie proprietà della rete hotspot, ad esempio percentuale della batteria, nome visualizzato, disponibilità e SSID/password.

Nota

Se vuoi usare questa API in un'app UWP e pubblica la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre info, vedi Funzionalità personalizzate.

La funzionalità Rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari hotspot Wi-Fi end-to-end tra un dispositivo hardware con supporto per il tethering e un PC Windows.
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)

Nota

Alcune informazioni sono relative a un prodotto non definitivo, che potrebbe subire modifiche sostanziali prima del rilascio sul mercato. Microsoft non offre alcuna garanzia, esplicita o implicita, relativamente alle informazioni fornite.

Importante

Questa API sarà interessata dalle modifiche imminenti al comportamento del sistema operativo, previsto per l'autunno 2024. Per altre informazioni, vedere Modifiche al comportamento dell'API per Wi-Fi l'accesso e la posizione.

Imposta su un oggetto WiFiOnDemandHotspotNetwork varie proprietà della rete hotspot, ad esempio percentuale della batteria, nome visualizzato, disponibilità e SSID/password. Se una proprietà non è valida, UpdateProperties genera un'eccezione di argomento non valida.

Nota

Se vuoi usare questa API in un'app UWP e pubblica la tua app in Microsoft Store, dovrai richiedere l'approvazione speciale per usare la funzionalità personalizzata Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (funzionalità di rete on demand). Per altre info, vedi Funzionalità personalizzate.

La funzionalità Rete on demand verrà resa disponibile solo per gli sviluppatori di app che creano scenari hotspot Wi-Fi end-to-end tra un dispositivo hardware con supporto per il tethering e un PC Windows.

Si applica a

Vedi anche

  • <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>