MBN_PROVIDER_STATE enumeration (mbnapi.h)

Important

Starting in Windows 10, version 1803, the Win32 APIs described in this section are replaced by the Windows Runtime APIs in the Windows.Networking.Connectivity namespace.

The MBN_PROVIDER_STATE enumerated type specifies the various states with which a provider entry can be tagged. These values are intended to be used together in a bitwise OR combination.

Syntax

typedef enum MBN_PROVIDER_STATE {
  MBN_PROVIDER_STATE_NONE,
  MBN_PROVIDER_STATE_HOME,
  MBN_PROVIDER_STATE_FORBIDDEN,
  MBN_PROVIDER_STATE_PREFERRED,
  MBN_PROVIDER_STATE_VISIBLE,
  MBN_PROVIDER_STATE_REGISTERED,
  MBN_PROVIDER_STATE_PREFERRED_MULTICARRIER
} ;

Constants

Name Description
MBN_PROVIDER_STATE_NONE Unknown provider state.
MBN_PROVIDER_STATE_HOME The provider is a home operator.
MBN_PROVIDER_STATE_FORBIDDEN The provider is on the forbidden list.
MBN_PROVIDER_STATE_PREFERRED The provider is on the preferred list.
MBN_PROVIDER_STATE_VISIBLE The provider is visible.
MBN_PROVIDER_STATE_REGISTERED Windows 8 or later: The provider is currently registered by the device.
MBN_PROVIDER_STATE_PREFERRED_MULTICARRIER Windows 8 or later: The provider is currently on the preferred multi-carrier list.

Remarks

The following table provides the valid combinations of values for different operations.

Operation MBN_PROVIDER_STATE
Query Home Provider MBN_PROVIDER_STATE_HOME
Query Preferred Providers MBN_PROVIDER_STATE_FORBIDDEN
MBN_PROVIDER_STATE_PREFERRED
Query Visible Providers MBN_PROVIDER_STATE_REGISTERED
MBN_PROVIDER_STATE_HOME
MBN_PROVIDER_STATE_PREFERRED
MBN_PROVIDER_STATE_FORBIDDEN

Requirements

   
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server None supported
Header mbnapi.h