MBN_PROVIDER structure (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 structure represents a network service provider. It is used by many of the provider-specific methods of IMbnInterface.

Syntax

typedef struct MBN_PROVIDER {
  BSTR  providerID;
  ULONG providerState;
  BSTR  providerName;
  ULONG dataClass;
} MBN_PROVIDER;

Members

providerID

Contains the provider ID. For GSM networks, this string is a concatenation of a 3-digit mobile country code (MCC) and a 2- or 3-digit mobile network code (MNC). For CDMA networks, this string is a 5-digit SID. The maximum length of this string is defined by MBN_PROVIDERID_LEN from MBN_PROVIDER_CONSTANTS. The caller must free this string by calling SysFreeString.

providerState

Contains a bitwise OR combination of MBN_PROVIDER_STATE values that represent the provider state.

providerName

Contains the provider name. The contents of this member should be ignored when setting the preferred provider list. The maximum length of this string is defined by MBN_PROVIDERNAME_LEN from MBN_PROVIDER_CONSTANTS. The string can be empty. The caller must free this string by calling SysFreeString.

dataClass

Contains a bitwise OR combination of MBN_DATA_CLASS values that indicate which data services are applicable or available for transfer. This member should be ignored when queried for the home provider.

Requirements

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

See also

MBN_PROVIDER2