WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) メソッド

定義

名前空間:

Windows.Devices.WiFi

注意

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

重要

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

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

注意

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

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの 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

注釈

• Id には、アプリが複数のオンデマンド ホットスポットを区別するために使用する任意の値を指定できます。 ただし、エフェメラル接続で最適なパフォーマンスを得る場合は、それぞれに新しいネットワークを作成するのではなく、同じ ID を再利用し、SSID とパスワードを更新することをお勧めします。
• ID はアプリ内でのみ一意である必要があります。
• 呼び出し元アプリにはパッケージ ID が必要です。