WiFiOnDemandHotspotNetwork Classe

  • Referência

Definição

Namespace:
Windows.Devices.WiFi
Editar

Observação

Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importante

Essa API será afetada pelas próximas alterações no comportamento do sistema operacional, previstas para o outono de 2024. Para obter mais informações, consulte Alterações no comportamento da API para Wi-Fi acesso e localização.

Representa um dispositivo que dá suporte ao hotspot sob demanda. O aplicativo registra esse dispositivo com o sistema operacional (SO), em que o aplicativo pode habilitar remotamente o hotspot móvel. Atualizando propriedades nesse objeto, o aplicativo pode sinalizar para o sistema operacional para atualizar a interface do usuário. O objeto é colocado em um GUID (identificador global exclusivo) escolhido pelo chamador que se destina a identificar o dispositivo (a propriedade Id ).

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada apenas para desenvolvedores de aplicativos que criam cenários de ponto de acesso de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador 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
Herança
Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos
Windows 11 Insider Preview (introduzida na 10.0.23504.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v15.0)
Funcionalidades do aplicativo
onDemandHotspotControl

Exemplos

Exemplo de hotspot sob demanda

Comentários

O hotspot sob demanda é o recurso no Windows que permite que um dispositivo cliente Windows exiba e habilite remotamente o ponto de acesso de compartilhamento de hotspot/Internet móvel em um dispositivo Windows host (um computador ou um telefone) e se conecte a ele. Isso permite que o dispositivo cliente compartilhe a conexão com a Internet do dispositivo host. Essa funcionalidade é exposta ao usuário injetando uma rede Wi-Fi na lista de rede do cliente quando o usuário abre o Wi-Fi Configurações Rápidas ou Wi-Fi redes disponíveis de Configurações do Sistema (Windows 11).

O aplicativo é responsável por determinar como se comunicar com o hotspot para obter os metadados, fora dessa API.

Propriedades

Id

Observação

Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importante

Essa API será afetada pelas próximas alterações no comportamento do sistema operacional, previstas para o outono de 2024. Para obter mais informações, consulte Alterações no comportamento da API para Wi-Fi acesso e localização.

Um GUID (identificador global exclusivo) escolhido pelo chamador que se destina a identificar o hotspot.

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.

Métodos

GetOrCreateById(Guid)

Observação

Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importante

Essa API será afetada pelas próximas alterações no comportamento do sistema operacional, previstas para o outono de 2024. Para obter mais informações, consulte Alterações no comportamento da API para Wi-Fi acesso e localização.

Se o sistema operacional (SO) já estiver configurado com um hotspot do aplicativo de chamada, GetOrCreateById recuperará o objeto WiFiOnDemandHotspotNetwork que corresponde ao networkId fornecido. Caso contrário, o método criará uma nova rede para essa ID.

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.
GetProperties()

Observação

Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importante

Essa API será afetada pelas próximas alterações no comportamento do sistema operacional, previstas para o outono de 2024. Para obter mais informações, consulte Alterações no comportamento da API para Wi-Fi acesso e localização.

Recupera de um objeto WiFiOnDemandHotspotNetwork várias propriedades da rede de hotspot, como porcentagem de bateria, nome de exibição, disponibilidade e SSID/senha.

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)

Observação

Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importante

Essa API será afetada pelas próximas alterações no comportamento do sistema operacional, previstas para o outono de 2024. Para obter mais informações, consulte Alterações no comportamento da API para Wi-Fi acesso e localização.

Define em um objeto WiFiOnDemandHotspotNetwork várias propriedades da rede de hotspot, como porcentagem de bateria, nome de exibição, disponibilidade e SSID/senha. Se alguma propriedade for inválida, UpdateProperties gerará uma exceção de argumento inválida.

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.

Aplica-se a

Confira também

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