WiFiOnDemandHotspotNetwork.UpdateProperties Método

Definição

Namespace:

Windows.Devices.WiFi

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 lançará 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 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:
 virtual void UpdateProperties(WiFiOnDemandHotspotNetworkProperties ^ newProperties) = UpdateProperties;

void UpdateProperties(WiFiOnDemandHotspotNetworkProperties const& newProperties);

public void UpdateProperties(WiFiOnDemandHotspotNetworkProperties newProperties);

function updateProperties(newProperties)

Public Sub UpdateProperties (newProperties As WiFiOnDemandHotspotNetworkProperties)

Parâmetros

newProperties

WiFiOnDemandHotspotNetworkProperties

Um objeto que representa as propriedades a serem definidas.

Requisitos do Windows

Funcionalidades do aplicativo

onDemandHotspotControl

Comentários

UpdateMetadata deve ser chamado regularmente pelo aplicativo, mesmo que nenhuma propriedade tenha sido alterada. Isso é para garantir que o Windows mostre a rede na Wi-Fi lista de redes disponíveis (em outras palavras, para que o Windows não a oculte por estar obsoleta). É recomendável registrar-se para a tarefa em segundo plano WiFiOnDemandHotspotUpdateMetadataTrigger e chamar UpdateMetadata lá.