NetworkOperatorTetheringAccessPointConfiguration Class

  • Reference

Definition

Namespace:
Windows.Networking.NetworkOperators
Edit

Provides the ability to configure and create an object that contains a specific tethering network SSID, and specifies the passphrase used to authenticate clients trying to establish a network connection to the tethering network.

Tethering allows a Windows device to function as a mobile hotspot providing internet connections over Wi-Fi or Bluetooth. Properties can be configured on the Wi-Fi access point such as the network SSID, the password, and the wireless frequency band.

public ref class NetworkOperatorTetheringAccessPointConfiguration sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class NetworkOperatorTetheringAccessPointConfiguration final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class NetworkOperatorTetheringAccessPointConfiguration final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class NetworkOperatorTetheringAccessPointConfiguration
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class NetworkOperatorTetheringAccessPointConfiguration
function NetworkOperatorTetheringAccessPointConfiguration()
Public NotInheritable Class NetworkOperatorTetheringAccessPointConfiguration
Inheritance
Object Platform::Object IInspectable NetworkOperatorTetheringAccessPointConfiguration
Attributes
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)
App capabilities
wiFiControl

Remarks

Windows 10, version 1607, supports Mobile Hotspot, an enhanced version of the mobile broadband tethering feature. The Mobile Hotspot and Wi-Fi Direct technology can't both run at the same time. Mobile Hotspot takes precedence over all Wi-Fi Direct scenarios. For example, screen projection and tethering can't both run at the same time.

Version history

Windows version SDK version Value added
2004 19041 Band
2004 19041 IsBandSupported
2004 19041 IsBandSupportedAsync

Constructors

NetworkOperatorTetheringAccessPointConfiguration()

Creates an instance of the NetworkOperatorTetheringAccessPointConfiguration.

Properties

AuthenticationKind

Gets or sets the authentication kind to be used for the Wi-Fi tethering connection.
Band

Gets or sets the wireless frequency band of the Wi-Fi access point. Use IsBandSupported or IsBandSupportedAsync to check whether the Wi-Fi adapter allows configuring a specific frequency band.
Passphrase

Gets or sets the passphrase used to authenticate the connection.

Note

As detailed in the 802.11 specification, a passphrase must contain between 8 and 63 characters in the standard ASCII printable character set.
Ssid

Gets or sets the SSID to be used for the tethering network.

Note

The SSID is encoded using the Microsoft code page for the system's default locale. This SSID may appear differently in the Windows network selection UI on a system that uses a different system locale. It is highly recommended that you set the value using characters from the standard ASCII printable character set to avoid any cross-locale inconsistencies.

Methods

IsAuthenticationKindSupported(TetheringWiFiAuthenticationKind)

Retrieves a value indicating whether the Wi-Fi adapter allows configuring the access point with a specific authentication kind.
IsAuthenticationKindSupportedAsync(TetheringWiFiAuthenticationKind)

Asynchronously retrieves a value indicating whether the Wi-Fi adapter allows configuring the access point with a specific authentication kind.
IsBandSupported(TetheringWiFiBand)

Checks whether the Wi-Fi access point supports the specified wireless frequency band.
IsBandSupportedAsync(TetheringWiFiBand)

Asynchronously checks whether the Wi-Fi access point supports the specified wireless frequency band.

Applies to