WiFiOnDemandHotspotNetwork.UpdateProperties 方法

定義

命名空間:

Windows.Devices.WiFi

注意

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

重要

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

在 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 。