ConnectionProfileFilter Class

Definition

public ref class ConnectionProfileFilter 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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConnectionProfileFilter final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ConnectionProfileFilter 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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConnectionProfileFilter

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

function ConnectionProfileFilter()

Public NotInheritable Class ConnectionProfileFilter

Inheritance

Object Platform::Object IInspectable ConnectionProfileFilter

Attributes

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows requirements

Examples

Carrier / service provider filtering (C#):

using Windows.Networking.Connectivity;

var carrierId = Guid.Parse("f68cd4bf-a388-4e8b-91ea-54dd6dd901c0"); // Replace with your known service provider GUID

// WWAN profiles
var wwanFilter = new ConnectionProfileFilter
{
    IsWwanConnectionProfile = true,
    ServiceProviderGuid = carrierId
};
var wwanProfiles = await NetworkInformation.FindConnectionProfilesAsync(wwanFilter);

// WLAN offload (create a new filter instead of mutating the prior one)
var wlanFilter = new ConnectionProfileFilter
{
    IsWlanConnectionProfile = true,
    ServiceProviderGuid = carrierId
};
var wlanProfiles = await NetworkInformation.FindConnectionProfilesAsync(wlanFilter);

Selecting a cellular profile with minimum connectivity level

using Windows.Networking.Connectivity;

var filter = new ConnectionProfileFilter
{
    IsWwanConnectionProfile = true,
    NetworkConnectivityLevel = NetworkConnectivityLevel.InternetAccess
};

var cellularProfiles = await NetworkInformation.FindConnectionProfilesAsync(filter);

Filtering by IMS purpose GUID (C++/WinRT)

#include <winrt/Windows.Networking.Connectivity.h>
using namespace winrt;
using namespace Windows::Networking::Connectivity;

IAsyncAction FindImsProfilesAsync()
{
    ConnectionProfileFilter filter;
    filter.IsWwanConnectionProfile(true);
    // IMS purpose GUID (authoritative WWAN context type)
    filter.PurposeGuid(winrt::guid{ L"{21610D01-3074-4BCE-9425-B53A07D697D6}" });

    auto profiles = co_await NetworkInformation::FindConnectionProfilesAsync(filter);

    for (auto const& profile : profiles)
    {
        auto details = profile.WwanConnectionProfileDetails();
        if (!details) continue;

        for (auto const& g : details.PurposeGuids())
        {
            if (g == winrt::guid{ L"{21610D01-3074-4BCE-9425-B53A07D697D6}" })
            {
                // App-specific: prioritize or attach IMS services for this profile
            }
        }
    }
}

Remarks

Purpose

Use ConnectionProfileFilter to narrow enumeration returned by FindConnectionProfilesAsync instead of processing the entire set from GetConnectionProfiles or relying solely on the current internet profile.

Guidance

• Start minimal; add properties only as needed to avoid over-constraining.
• Prefer IsWlanConnectionProfile / IsWwanConnectionProfile over parsing names to detect technology.
• Retrieve usage after filtering by calling ConnectionProfile.GetNetworkUsageAsync rather than inferring it from filter inputs.
• Combine cost and connectivity level constraints only when necessary; connectivity can fluctuate during transitions.

Purpose / service provider GUID

Use PurposeGuid (or ServiceProviderGuid) only when you possess a valid value (carrier provisioning / enterprise policy). An incorrect GUID silently yields zero results.

Purpose GUID sources

Purpose GUIDs are standardized identifiers surfaced by the Windows WWAN stack (MBIM context type GUIDs) and appear on provisioned cellular profiles created by carrier/OEM provisioning or enterprise (MDM) policy. Do not invent or randomize values; use only those delivered through official provisioning channels.

For the complete list of purpose GUIDs, see PurposeGroupGuid.

Typical usage scenarios:

• Selecting a specialized IMS profile for voice/video service enablement.
• Isolating SUPL (assisted GPS) data contexts for cost or routing decisions.

Keep filtering logic narrow: specify PurposeGuid plus IsWwanConnectionProfile only; add other constraints (e.g., connectivity level) only if required.

Cost / connectivity considerations

Applying multiple cost states (for example forcing a specific NetworkCostType plus roaming flags) can remove legitimate candidates. After selecting profiles, inspect each profile's ConnectionCost for adaptive behavior.

Common pitfalls

Functional selection examples

• All currently connected profiles across technologies: set IsConnected to true; leave technology flags unset.
• Separate technology + provider logic: run distinct queries per technology when ServiceProviderGuid is involved (no OR across technologies in a single filter).

See also

• ConnectionProfile
• PurposeGuid
• PurposeGuids
• CM_CellularEntries CSP
• PurposeGroups