Share via

WiFiOnDemandHotspotNetwork 类

  • 参考

定义

命名空间:
Windows.Devices.WiFi
编辑

注意

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

重要

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

表示支持 按需热点的设备。 应用将该设备注册到操作系统 (操作系统) ，其中应用可以远程启用移动热点。 通过更新此对象的属性，应用可以向 OS 发出信号，以更新用户界面 (UI) 。 对象在调用方选择的全局唯一标识符 (GUID) 上键，该标识符旨在 (id 属性) 标识设备。

注意

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

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

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
继承
Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列
Windows 11 Insider Preview (在 10.0.23504.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v15.0 中引入)
应用功能
onDemandHotspotControl

示例

按需热点示例

注解

按需热点 是 Windows 中的一项功能，它允许 Windows 客户端设备在主机 Windows 设备上查看和远程启用移动热点/Internet 共享接入点， (电脑或手机) ，并连接到它。 这允许客户端设备共享主机设备的 Internet 连接。 当用户打开 Wi-Fi“快速设置”或 Wi-Fi“系统设置”可用网络 (Windows 11) 时，通过将 Wi-Fi 网络注入客户端的网络列表，向用户公开此功能。

应用负责确定如何与此 API 外部的热点通信以获取元数据。

属性

Id

注意

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

重要

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

调用方选择的全局唯一标识符 (用于标识热点的 GUID) 。

注意

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

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

方法

GetOrCreateById(Guid)

注意

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

重要

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

如果操作系统 (操作系统) 已配置有来自调用应用的热点，则 GetOrCreateById 将检索与给定 networkId 对应的 WiFiOnDemandHotspotNetwork 对象。 否则， 方法会为该 ID 创建新网络。

注意

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

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

注意

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

重要

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

从 WiFiOnDemandHotspotNetwork 对象检索热点网络的各种属性，例如电池百分比、显示名称、可用性和 SSID/密码。

注意

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

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

注意

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

重要

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

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

注意

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

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

适用于

另请参阅

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