WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) 方法

定义

重要

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

编辑

注意

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

重要

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

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

注意

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

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

public:
 static WiFiOnDemandHotspotNetwork ^ GetOrCreateById(Platform::Guid networkId);

 static WiFiOnDemandHotspotNetwork GetOrCreateById(winrt::guid const& networkId);

public static WiFiOnDemandHotspotNetwork GetOrCreateById(Guid networkId);

function getOrCreateById(networkId)

Public Shared Function GetOrCreateById (networkId As Guid) As WiFiOnDemandHotspotNetwork

全局唯一标识符 (标识 WiFiOnDemandHotspotNetwork 对象的 GUID) 。

已创建或检索的对象。

应用功能	onDemandHotspotControl

Id 可以是应用选择用于区分多个按需热点的任何值。但是，为了获得临时连接的最佳性能，我们建议重用相同的 ID 并更新 SSID 和密码，而不是为每个网络创建新网络。
ID 只需在应用中是唯一的。
调用应用必须具有包标识。