WiFiOnDemandHotspotNetwork 類別

定義

命名空間:

Windows.Devices.WiFi

注意

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

重要

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

表示支援 隨選熱點的裝置。 應用程式會向作業系統 (作業系統) 註冊該裝置，讓應用程式可以從遠端啟用行動熱點。 藉由更新此物件上的屬性，應用程式可以向 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 裝置上檢視和遠端啟用行動熱點/網際網路共用存取點， (電腦或手機) ，並聯機到它。 這可讓用戶端裝置共用主機裝置的網際網路連線。 當使用者開啟 Wi-Fi [快速設定] 或 [Wi-Fi 系統設定] 可用的 (Windows 11) 網路時，將 Wi-Fi 網路插入用戶端的網路清單中，即可向使用者公開這項功能。

應用程式負責判斷如何與熱點通訊，以取得此 API 外部的中繼資料。

屬性

Id

注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 呼叫者選擇的全域唯一識別碼， (GUID) ，用來識別熱點。 注意 如果您想要在 UWP 應用程式中使用此 API，並將您的應用程式發佈至 Microsoft Store，則必須要求特殊核准，才能使用自訂功能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (隨選網路功能) 。 如需詳細資訊，請參閱 自訂功能。 隨選網路功能僅可供應用程式開發人員在支援連線的硬體裝置與 Windows 電腦之間建置端對端 Wi-Fi 熱點案例。

方法

GetOrCreateById(Guid)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 如果作業系統 (作業系統) 已設定來自呼叫應用程式的熱點，則 GetOrCreateById會擷取對應至指定networkId的WiFiOnDemandHotspotNetwork物件。 否則，方法會為該識別碼建立新的網路。 注意 如果您想要在 UWP 應用程式中使用此 API，並將您的應用程式發佈至 Microsoft Store，則必須要求特殊核准，才能使用自訂功能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (隨選網路功能) 。 如需詳細資訊，請參閱 自訂功能。 隨選網路功能僅可供應用程式開發人員在支援連線的硬體裝置與 Windows 電腦之間建置端對端 Wi-Fi 熱點案例。
GetProperties()	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 從 WiFiOnDemandHotspotNetwork 物件擷取熱點網路的各種屬性，例如電池百分比、顯示名稱、可用性和 SSID/密碼。 注意 如果您想要在 UWP 應用程式中使用此 API，並將您的應用程式發佈至 Microsoft Store，則必須要求特殊核准，才能使用自訂功能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (隨選網路功能) 。 如需詳細資訊，請參閱 自訂功能。 隨選網路功能僅可供應用程式開發人員在支援連線的硬體裝置與 Windows 電腦之間建置端對端 Wi-Fi 熱點案例。
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)	注意 針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，Microsoft 不做任何明示或默許的擔保。 重要 此 API 將受到即將變更的作業系統行為所影響，其計畫為 2024 年 2024 年。 如需詳細資訊，請參閱 Wi-Fi 存取和位置的 API 行為變更。 在 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)>