WiFiOnDemandHotspotNetwork 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
注意
針對發行前產品的部分相關資訊，在產品正式發行時可能會有大幅修改。 針對此處提供的資訊，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 WiFiOnDemandHotspotNetworkPublic NotInheritable Class WiFiOnDemandHotspotNetwork- 繼承
- 屬性
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)>