WiFiOnDemandHotspotNetwork Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 WiFiOnDemandHotspotNetworkPublic NotInheritable Class WiFiOnDemandHotspotNetwork- Herança
- Atributos
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)>
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de