WiFiOnDemandHotspotNetwork クラス

  • リファレンス

定義

名前空間:
Windows.Devices.WiFi
編集

注意

一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

重要

この API は、2024 年秋に予定されているオペレーティング システムの動作に対する今後の変更の影響を受けます。 詳細については、「 Wi-Fi アクセスと場所の API 動作の変更」を参照してください。

オンデマンド ホットスポットをサポートするデバイスを表します。 アプリは、そのデバイスをオペレーティング システム (OS) に登録します。ここで、アプリはリモートでモバイル ホットスポットを有効にすることができます。 このオブジェクトのプロパティを更新することで、アプリは OS に通知してユーザー インターフェイス (UI) を更新できます。 オブジェクトは、デバイス ( Id プロパティ) を識別することを目的とした、呼び出し元が選択したグローバル一意識別子 (GUID) でキーが設定されます。

注意

この API を UWP アプリで使用し、アプリを Microsoft Store に発行する場合は、カスタム機能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (オンデマンド ネットワーク機能) を使用するための特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの 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 デバイス (PC または電話) 上のモバイル ホットスポット/インターネット共有アクセス ポイントを表示してリモートで有効にし、それに接続できるようにする Windows の機能です。 これにより、クライアント デバイスはホスト デバイスのインターネット接続を共有できます。 この機能は、ユーザーが [Wi-Fi クイック設定] または [Wi-Fi システム設定] 使用可能なネットワーク (Windows 11) を開いたときに、Wi-Fi ネットワークをクライアントのネットワーク リストに挿入することによって、ユーザーに公開されます。

アプリは、この API の外部で、ホットスポットと通信してメタデータを取得する方法を決定する役割を担います。

プロパティ

Id

注意

一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

重要

この API は、2024 年秋に予定されているオペレーティング システムの動作に対する今後の変更の影響を受けます。 詳細については、「 Wi-Fi アクセスと場所の API 動作の変更」を参照してください。

ホットスポットを識別することを目的とした、呼び出し元が選択したグローバル一意識別子 (GUID)。

注意

UWP アプリでこの API を使用し、アプリを Microsoft Store に発行する場合は、カスタム機能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (オンデマンド ネットワーク機能) を使用するための特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの Wi-Fi ホットスポット シナリオを構築するアプリ開発者のみが利用できるようになります。

メソッド

GetOrCreateById(Guid)

注意

一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

重要

この API は、2024 年秋に予定されているオペレーティング システムの動作に対する今後の変更の影響を受けます。 詳細については、「 Wi-Fi アクセスと場所の API 動作の変更」を参照してください。

オペレーティング システム (OS) が呼び出し元アプリからホットスポットで既に構成されている場合、GetOrCreateById は、指定された networkId に対応する WiFiOnDemandHotspotNetwork オブジェクトを取得します。 それ以外の場合、メソッドはその ID の新しいネットワークを作成します。

注意

UWP アプリでこの API を使用し、アプリを Microsoft Store に発行する場合は、カスタム機能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (オンデマンド ネットワーク機能) を使用するための特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの Wi-Fi ホットスポット シナリオを構築するアプリ開発者のみが利用できるようになります。
GetProperties()

注意

一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

重要

この API は、2024 年秋に予定されているオペレーティング システムの動作に対する今後の変更の影響を受けます。 詳細については、「 Wi-Fi アクセスと場所の API 動作の変更」を参照してください。

バッテリーの割合、表示名、可用性、SSID/パスワードなど、ホットスポット ネットワークのさまざまなプロパティを WiFiOnDemandHotspotNetwork オブジェクトから取得します。

注意

UWP アプリでこの API を使用し、アプリを Microsoft Store に発行する場合は、カスタム機能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (オンデマンド ネットワーク機能) を使用するための特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの Wi-Fi ホットスポット シナリオを構築するアプリ開発者のみが利用できるようになります。
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)

注意

一部の情報はリリース前の製品に関する事項であり、正式版がリリースされるまでに大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

重要

この API は、2024 年秋に予定されているオペレーティング システムの動作に対する今後の変更の影響を受けます。 詳細については、「 Wi-Fi アクセスと場所の API 動作の変更」を参照してください。

バッテリーの割合、表示名、可用性、SSID/パスワードなど、ホットスポット ネットワークのさまざまなプロパティを WiFiOnDemandHotspotNetwork オブジェクトに設定します。 いずれかのプロパティが無効な場合、 UpdateProperties は無効な引数例外をスローします。

注意

UWP アプリでこの API を使用し、アプリを Microsoft Store に発行する場合は、カスタム機能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (オンデマンド ネットワーク機能) を使用するための特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの Wi-Fi ホットスポット シナリオを構築するアプリ開発者のみが利用できるようになります。

適用対象

こちらもご覧ください

  • <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>