NetworkOperatorTetheringSessionAccessPointConfiguration 類別

參考

定義

命名空間:: Windows.Networking.NetworkOperators

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

包含用來設定 Wi-Fi 連線熱點以及相關協助程式方法的所有個別會話設定字段。

NetworkOperatorTetheringSessionAccessPointConfiguration 包含與其持續對應 NetworkOperatorTetheringAccessPointConfiguration 相同的欄位和協助程式方法，並新增數個。但 NetworkOperatorTetheringSessionAccessPointConfiguration 的所有可設定屬性都會視為每個會話，包括所有共享屬性。

NetworkOperatorTetheringSessionAccessPointConfiguration 主要與 StartTetheringAsync 搭配使用，以指定每個會話的聯機設定。這麼做不會清除或改變現有的持續性設定。呼叫不含參數的 StartTetheringAsync 一律會使用透過 ConfigureAccessPointAsync 預先設定的持續性設定。

public ref class NetworkOperatorTetheringSessionAccessPointConfiguration sealed

/// [Windows.Foundation.Metadata.Activatable(1114112, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 1114112)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class NetworkOperatorTetheringSessionAccessPointConfiguration final

[Windows.Foundation.Metadata.Activatable(1114112, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 1114112)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class NetworkOperatorTetheringSessionAccessPointConfiguration

function NetworkOperatorTetheringSessionAccessPointConfiguration()

Public NotInheritable Class NetworkOperatorTetheringSessionAccessPointConfiguration

繼承: Object Platform::Object IInspectable NetworkOperatorTetheringSessionAccessPointConfiguration

屬性: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 11, version 24H2 (已於 10.0.26100.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v19.0 引進)
應用程式功能	wiFiControl

範例

Windows.Networking.NetworkOperators 命名空間中的連線 API 提供一組完整的功能，可讓您以程式設計方式設定和控制連線 (，也就是與其他裝置共用裝置的因特網連線) 。下列程式代碼範例示範如何使用每個會話的共享組態。

透過每個會話的共享設定，您可以暫時覆寫永續性共用熱點設定，而不會永久改變它。這在需要暫存設定時特別有用。例如，使用行動熱點將 HMD 連線到計算機時，但當您想要透過暫時 Wi-Fi 網路連接裝置，而不需向使用者顯示設定詳細數據，以及變更使用者目前的行動熱點設定，盡可能順暢地進行動作時。

此外，若要達到與計算機的低延遲和低抖動連線，您可能想要使用 6 GHz 連線。如果使用者的計算機透過 5 GHz Wi-Fi 連線到因特網，則行動熱點無法在 6 GHz 頻帶上啟動。因此，每個會話參數 PerformancePriority 會告知驅動程式如何設定連線熱點與月台連線之間的效能優先順序。 Default 常數會告知驅動程式將月台聯機的優先順序設定為其他所有專案。另一方面， TetheringOverStation 會告知驅動程式排定連線熱點的效能優先順序，因此，讓驅動程式視需要將月台聯機降級至 2.4 GHz。這一切都要盡可能為使用者提供順暢的體驗，而不需要他們個人變更熱點設定和月台連線。

下列程式代碼範例會展示：

API 支持驗證。您的應用程式必須測試它是否在上執行的操作系統支援每個會話的聯機組態。若要這樣做，請使用 ApiInformation.IsApiContractPresent 方法。
取得共用管理員。程式代碼範例的本機定義 GetTetheringManagerForCurrentConnection 方法會識別正在使用中的因特網連線配置檔，並擷取對應至該配置檔的連線管理員。稍後會使用共用管理員來擷取主要存取點設定，並啟動實際的共享會話。
設定會話組態。您可以從現有的主要組態衍生聯機會話設定，或從頭開始設定一個。然後，您可以設定或修改各種參數，例如 SSID、複雜密碼、訊號範圍、驗證種類和效能優先順序。
啟動共享工作階段。會話設定可以傳遞至 StartTetheringAsync 方法來起始共享工作階段。此方法也會透過 TetheringOperationStatus 列舉提供廣泛的意見反應，以提供對作業結果的細微瞭解。

using System;
using System.Threading.Tasks;
using Windows.Foundation.Metadata;
using Windows.Networking.NetworkOperators;
using Windows.Networking.Connectivity;

namespace TetheringApiDemoApp
{
  static class TetheringApiDemoClass
  {
    // Sample desired per-session access point configuration values.
    private const string DesiredSsid = "DemoSsid";

    private const string DesiredPassphrase = "DemoPassphrase";

    private const TetheringWiFiBand DesiredBand =
      TetheringWiFiBand.SixGigahertz;

    private const TetheringWiFiAuthenticationKind DesiredAuthenticationKind =
      TetheringWiFiAuthenticationKind.Wpa3;

    private const TetheringWiFiPerformancePriority DesiredPerformancePriority =
      TetheringWiFiPerformancePriority.TetheringOverStation;

    public static void VerifyPerSessionTetheringApiSupport()
    {
      if (!ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 17))
      {
        throw new InvalidOperationException(
          "This OS doesn't support per-session tethering configurations.");
      }
    }

    public static NetworkOperatorTetheringManager GetTetheringManagerForCurrentConnection()
    {
      // Get the connection profile associated with the internet connection currently used by the local machine.
      ConnectionProfile currentConnectionProfile = NetworkInformation.GetInternetConnectionProfile();

      if (currentConnectionProfile == null)
      {
        throw new InvalidOperationException("Machine isn't connected to the internet.");
      }

      TetheringCapability tetheringCapability =
        NetworkOperatorTetheringManager.GetTetheringCapabilityFromConnectionProfile(currentConnectionProfile);

      if (tetheringCapability != TetheringCapability.Enabled)
      {
        throw new InvalidOperationException(
          $"Tethering is disabled on this machine. Reason code: {tetheringCapability}.");
      }

      return NetworkOperatorTetheringManager.CreateFromConnectionProfile(currentConnectionProfile);
    }

    public static async Task<NetworkOperatorTetheringSessionAccessPointConfiguration>
      SetUpSessionConfigurationAsync(NetworkOperatorTetheringManager tetheringManager)
    {
      NetworkOperatorTetheringSessionAccessPointConfiguration sessionConfiguration =
         new NetworkOperatorTetheringSessionAccessPointConfiguration();

      sessionConfiguration.Ssid = DesiredSsid;
      sessionConfiguration.Passphrase = DesiredPassphrase;

      if (await sessionConfiguration.IsBandSupportedAsync(DesiredBand))
      {
        sessionConfiguration.Band = DesiredBand;
      }
      else
      {
        throw new InvalidOperationException("Desired band isn't supported.");
      }

      if (await sessionConfiguration.IsAuthenticationKindSupportedAsync(DesiredAuthenticationKind))
      {
        sessionConfiguration.AuthenticationKind = DesiredAuthenticationKind;
      }
      else
      {
        throw new InvalidOperationException("Desired authentication kind isn't supported.");
      }

      sessionConfiguration.PerformancePriority = DesiredPerformancePriority;

      return sessionConfiguration;
    }

    public static async Task StartTetheringSessionAsync(
      NetworkOperatorTetheringManager tetheringManager,
      NetworkOperatorTetheringSessionAccessPointConfiguration sessionConfiguration)
    {
      TetheringOperationStatus operationResult =
        await tetheringManager.StartTetheringAsync(sessionConfiguration);

      if (operationResult.Status == TetheringOperationStatus.Success)
      {
        Console.WriteLine("Tethering started successfully.");
      }
      else if (operationResult.Status == TetheringOperationStatus.AlreadyOn)
      {
        // Custom error message for AlreadyOn status.
        Console.WriteLine("Tethering is already on.");
      }
      else if (operationResult.Status == TetheringOperationStatus.RadioRestriction)
      {
        // Custom error message for RadioRestriction status.
        Console.WriteLine(
          "Can't start tethering at 6 GHz due to radio restrictions (2x2 + dual radio).");
      }
      else if (operationResult.Status == TetheringOperationStatus.BandInterference)
      {
        // Custom error message for BandInterference status.
        Console.WriteLine(
          "Can't start tethering at 6 GHz because a 5 GHz connection interferes.");
      }
      else
      {
        // Generic error message for all other statuses.
        Console.WriteLine(
          $"Failed to start tethering: {operationResult.AdditionalErrorMessage}.");
      }
    }

    public static async Task Main()
    {
      try
      {
        VerifyPerSessionTetheringApiSupport();

        NetworkOperatorTetheringManager tetheringManager = GetTetheringManagerForCurrentConnection();

        NetworkOperatorTetheringSessionAccessPointConfiguration sessionConfiguration =
          await SetUpSessionConfigurationAsync(tetheringManager);

        await StartTetheringSessionAsync(tetheringManager, sessionConfiguration);
      }
      catch (InvalidOperationException ex)
      {
        Console.WriteLine($"Failed to initialize tethering configuration: {ex.Message}.");
      }
      catch (Exception ex)
      {
        Console.WriteLine($"Unexpected error: {ex.Message}.");
      }
    }
  }
}

備註

共用是一項功能，可讓 Windows 裝置作為行動熱點運作：透過 Wi-Fi 或藍牙提供其他裝置的因特網連線。您可以在 Wi-Fi 連線熱點上設定四個永續性欄位：網路 SSID、網路密碼、網路無線網路頻 (例如 2.4 GHz、5 GHz、6 GHz) ，以及網路驗證演算法 (例如 WPA2、WPA3) 。設定之後，所有欄位都會在共用工作階段之間保存;這表示值會儲存在非揮發性記憶體中。

但您也可以使用完全個別會話設定來啟動共享會話。每個會話的共享組態不會在共享會話之間保存，也不會改變目前的持續性設定。每個工作階段欄位是 效能優先順序。

因此 ，NetworkOperatorTetheringSessionAccessPointConfiguration 的目的是在透過 StartTetheringAsync 啟動共享會話時指定個別會話的共享設定。這個僅限會話類別的其他成員通常是使用者透過 Windows 設定目前無法設定的值。

建構函式

NetworkOperatorTetheringSessionAccessPointConfiguration()

建立 NetworkOperatorTetheringSessionAccessPointConfiguration 的實例。

屬性

AuthenticationKind	取得或設定要用於 Wi-Fi 連線的驗證種類。類似於 NetworkOperatorTetheringAccessPointConfiguration.AuthenticationKind。
Band	取得或設定要用於 Wi-Fi 連線的頻率帶。類似於 NetworkOperatorTetheringAccessPointConfiguration.Band。
Passphrase	取得或設定要用於 Wi-Fi 連線的網路複雜密碼。類似於 NetworkOperatorTetheringAccessPointConfiguration.Passphrase。
PerformancePriority	取得或設定當主要因特網連線也透過Wi-Fi時，要用於 Wi-Fi 連線的效能優先順序值。如果站台聯機位於干擾所要求頻率帶的頻帶上，則 Wi-Fi 晶元組會嘗試將連接的頻率頻帶變更為不會干擾的另一個頻率帶。許多 Wi-Fi 晶元組都有一項限制，其中如果主要連線超過 5 GHz 波段，則無法將連接熱點設定為使用 6 GHz 帶。將連線的優先順序設定為 (TetheringOverStation) 會告訴 Wi-Fi 晶片組嘗試將主要連線變更為 2.4 GHz 波段，如此一來，就不會再干擾所要求 6 GHz 的網狀區域。如果無法或藉由指定不同的效能優先順序值來允許頻率帶移位，則呼叫 StartTetheringAsync 將會失敗，並出現適當的結果狀態， (BandInterference) 。
Ssid	取得或設定要用於 Wi-Fi 連線的網路 SSID。類似於 NetworkOperatorTetheringAccessPointConfiguration.Ssid。

方法

IsAuthenticationKindSupported(TetheringWiFiAuthenticationKind)	取得值，指出 Wi-Fi 配接器是否允許使用特定驗證種類來設定連線熱點。類似於 NetworkOperatorTetheringAccessPointConfiguration.IsAuthenticationKindSupported。
IsAuthenticationKindSupportedAsync(TetheringWiFiAuthenticationKind)	以異步方式取得值，指出 Wi-Fi 配接器是否允許使用特定驗證種類來設定連接熱點。類似於 NetworkOperatorTetheringAccessPointConfiguration.IsAuthenticationKindSupportedAsync。
IsBandSupported(TetheringWiFiBand)	取得值，指出 Wi-Fi 配接器是否允許使用特定頻率帶設定連接熱點。類似於 NetworkOperatorTetheringAccessPointConfiguration.IsBandSupported。
IsBandSupportedAsync(TetheringWiFiBand)	以異步方式取得值，指出 Wi-Fi 配接器是否允許使用特定頻率帶設定連接熱點。類似於 NetworkOperatorTetheringAccessPointConfiguration.IsBandSupportedAsync。

適用於

共用方式為

NetworkOperatorTetheringSessionAccessPointConfiguration 類別

定義

Windows 需求

範例

備註

建構函式

屬性

方法

適用於

意見反應

其他資源