ManagedNativeWifi

If you are upgrading to version 3.0.1, be aware of the following breaking changes that affect existing code:

• InterfaceConnectionInfo: The ConnectionMode and ProfileName properties have been removed. To retrieve this information, use the GetCurrentConnection method instead.
• ScanMode Enum: The value OnlyDisconnectd has been renamed to OnlyNotConnected.
• BssNetworkPack: The SignalStrength property has been renamed to Rssi. This affects the output of EnumerateBssNetworks.
• Radio Management Methods: The following methods have been renamed:
  • GetInterfaceRadio $\rightarrow$ GetRadio
  • TurnOnInterfaceRadio $\rightarrow$ TurnOnRadio
  • TurnOffInterfaceRadio $\rightarrow$ TurnOffRadio
• AutoConfig: IsInterfaceAutoConfig is the current name (previously IsInterfaceAutoConfig in older versions, but note the specific renaming history).
• RadioInfo: The Id property has been removed. This affects the return of GetRadio.
• Radio State: RadioSet and PhyRadioStateInfo have been replaced by RadioStateSet. This affects both GetRadio and the RadioStateChangedEventArgs event arguments.
• Connection Methods: The type of the bssid parameter in ConnectNetwork and ConnectNetworkAsync has changed.

To get information about currently connected wireless interfaces, use the following methods depending on your requirements:

1. NativeWifi.GetCurrentConnection(interfaceId): Returns general connection details like SSID, PHY type, authentication, cipher, signal quality, and Rx/Tx rates.
2. NativeWifi.GetRealtimeConnectionQuality(interfaceId): Requires Windows 11 24H2. Provides real-time metrics like link quality, MLO (Multi-Link Operation) status, and detailed link information (RSSI, Frequency, Bandwidth).
3. NativeWifi.GetRssi(interfaceId): A fallback to get the RSSI if GetRealtimeConnectionQuality is not supported.

Note: All these methods return a tuple containing an ActionResult. If the interface is not connected, the result will be ActionResult.NotConnected.

public static void ShowConnectedNetworkInformation()
{
    foreach (var interfaceId in NativeWifi.EnumerateInterfaces()
        .Where(x => x.State is InterfaceState.Connected)
        .Select(x => x.Id))
    {
        // Get general connection info
        var (result, cc) = NativeWifi.GetCurrentConnection(interfaceId);
        if (result is ActionResult.Success)
        {
            Trace.WriteLine($"SSID: {cc.Ssid}");
            Trace.WriteLine($"Signal quality: {cc.SignalQuality}");
        }

        // Get real-time quality (Windows 11 24H2+)
        (result, var rcq) = NativeWifi.GetRealtimeConnectionQuality(interfaceId);
        if (result is ActionResult.Success)
        {
            Trace.WriteLine($"Link quality: {rcq.LinkQuality}");
            if (rcq.Links.Count > 0)
            {
                Trace.WriteLine($"RSSI: {rcq.Links[0].Rssi}");
            }
        }
        else if (result is ActionResult.NotSupported)
        {
            // Fallback to RSSI
            (result, int rssi) = NativeWifi.GetRssi(interfaceId);
            if (result is ActionResult.Success)
            {
                Trace.WriteLine($"RSSI: {rssi}");
            }
        }
    }
}

To enable the wireless radio, first check the current state using NativeWifi.GetRadio, then call NativeWifi.TurnOnRadio.

Limitations:

• This method only changes the software radio state.
• If the hardware radio state is off (e.g., a physical Wi-Fi switch is off), the radio cannot be turned on programmatically.
• Calling this may throw an UnauthorizedAccessException if permissions are insufficient.

public static async Task<bool> TurnOnAsync()
{
    var targetInterface = NativeWifi.EnumerateInterfaces()
        .FirstOrDefault(x =>
        {
            var radioState = NativeWifi.GetRadio(x.Id)?.RadioStates.FirstOrDefault();
            if (radioState is null) return false;
            if (!radioState.IsHardwareOn) return false;
            return !radioState.IsSoftwareOn;
        });

    if (targetInterface is null) return false;

    try
    {
        return await Task.Run(() => NativeWifi.TurnOnRadio(targetInterface.Id));
    }
    catch (UnauthorizedAccessException)
    {
        return false;
    }
}

Use NativeWifi.ConnectNetworkAsync to connect to a wireless network.

Unlike the synchronous ConnectNetwork method (which only indicates if the request succeeded), ConnectNetworkAsync returns true only if the connection is successfully established.

Required parameters:

• interfaceId: The ID of the wireless interface.
• profileName: The name of the wireless profile.
• bssType: The BSS type.
• timeout: A TimeSpan for the connection attempt.

public static async Task<bool> ConnectAsync()
{
    var availableNetwork = NativeWifi.EnumerateAvailableNetworks()
        .Where(x => !string.IsNullOrWhiteSpace(x.ProfileName))
        .OrderByDescending(x => x.SignalQuality)
        .FirstOrDefault();

    if (availableNetwork is null)
        return false;

    return await NativeWifi.ConnectNetworkAsync(
        interfaceId: availableNetwork.InterfaceInfo.Id,
        profileName: availableNetwork.ProfileName,
        bssType: availableNetwork.BssType,
        timeout: TimeSpan.FromSeconds(10));
}