WiFiOnDemandHotspotNetwork 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
注意
一些信息与预发行产品相关，相应产品在商业发行之前可能会进行重大修改。 对于此处提供的信息，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 WiFiOnDemandHotspotNetworkPublic NotInheritable Class WiFiOnDemandHotspotNetwork- 继承
- 属性
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)>