WiFiOnDemandHotspotNetwork.UpdateProperties 方法

定义

命名空间:

Windows.Devices.WiFi

注意

一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重要

此 API 将受到即将于 2024 年秋季进行的操作系统行为更改的影响。 有关详细信息，请参阅 更改 api 行为的 Wi-Fi 访问和位置。

在 WiFiOnDemandHotspotNetwork 对象上设置热点网络的各种属性，例如电池百分比、显示名称、可用性和 SSID/密码。 如果任何属性无效， UpdateProperties 将引发无效参数异常。

注意

如果要在 UWP 应用中使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能使用 自定义功能Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (按需网络功能) 。 有关详细信息，请参阅 自定义功能。

按需网络功能将仅提供给在支持网络连接的硬件设备和 Windows 电脑之间构建端到端 Wi-Fi 热点方案的应用开发人员。

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)

参数

newProperties

WiFiOnDemandHotspotNetworkProperties

表示要设置的属性的 对象。

Windows 要求

应用功能	onDemandHotspotControl

注解

UpdateMetadata 应用应定期调用，即使没有更改任何属性。 这是为了确保 Windows 会在 Wi-Fi 可用网络列表中显示该网络 (换句话说，因此 Windows 不会隐藏它，因为) 过时。 建议注册 WiFiOnDemandHotspotUpdateMetadataTrigger 后台任务并在那里调用 UpdateMetadata 。