共用方式為

WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) 方法

  • 參考

定義

命名空間:
Windows.Devices.WiFi
編輯

注意

針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。

重要

此 API 將受到即將變更作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。

如果作業系統 (OS) 已使用來自呼叫應用程式的熱點進行設定，則 GetOrCreateById會擷取對應至指定networkId的WiFiOnDemandHotspotNetwork物件。 否則，方法會為該識別碼建立新的網路。

注意

如果您想要在 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

參數

networkId
Guid

Platform::Guid

winrt::guid

識別 WiFiOnDemandHotspotNetwork 物件的全域唯一識別碼) (GUID。

傳回

WiFiOnDemandHotspotNetwork

已建立或擷取的物件。

Windows 需求

應用程式功能
onDemandHotspotControl

備註

  • 識別碼可以是應用程式選擇用來區分多個隨選熱點的任何值。 不過，為了達到暫時連線的最佳效能，建議您重複使用相同的識別碼並更新 SSID 和密碼，而不是為每個連線建立新的網路。
  • 識別碼只需要在應用程式內是唯一的。
  • 呼叫的應用程式必須具有套件身分識別。

適用於