Edit

Share via

MBN_PROVIDER_STATE enumeration (mbnapi.h)

  • Article

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 = 0,
  MBN_PROVIDER_STATE_HOME = 0x1,
  MBN_PROVIDER_STATE_FORBIDDEN = 0x2,
  MBN_PROVIDER_STATE_PREFERRED = 0x4,
  MBN_PROVIDER_STATE_VISIBLE = 0x8,
  MBN_PROVIDER_STATE_REGISTERED = 0x10,
  MBN_PROVIDER_STATE_PREFERRED_MULTICARRIER = 0x20
} ;

Constants

 
MBN_PROVIDER_STATE_NONE
Value: 0
Unknown provider state.
MBN_PROVIDER_STATE_HOME
Value: 0x1
The provider is a home operator.
MBN_PROVIDER_STATE_FORBIDDEN
Value: 0x2
The provider is on the forbidden list.
MBN_PROVIDER_STATE_PREFERRED
Value: 0x4
The provider is on the preferred list.
MBN_PROVIDER_STATE_VISIBLE
Value: 0x8
The provider is visible.
MBN_PROVIDER_STATE_REGISTERED
Value: 0x10
Windows 8 or later: The provider is currently registered by the device.
MBN_PROVIDER_STATE_PREFERRED_MULTICARRIER
Value: 0x20
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

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