MBN_PROVIDER structure (mbnapi.h)

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

See also

MBN_PROVIDER2