MBN_INTERFACE_CAPS structure (mbnapi.h)

The MBN_INTERFACE_CAPS structure represents the interface capabilities. This structure is returned by the GetInterfaceCapability method of IMbnInterface.

Syntax

typedef struct MBN_INTERFACE_CAPS {
  MBN_CELLULAR_CLASS cellularClass;
  MBN_VOICE_CLASS    voiceClass;
  ULONG              dataClass;
  BSTR               customDataClass;
  ULONG              gsmBandClass;
  ULONG              cdmaBandClass;
  BSTR               customBandClass;
  ULONG              smsCaps;
  ULONG              controlCaps;
  BSTR               deviceID;
  BSTR               manufacturer;
  BSTR               model;
  BSTR               firmwareInfo;
} MBN_INTERFACE_CAPS;

Members

cellularClass

An MBN_CELLULAR_CLASS value that specifies the cellular technology used by the device.

voiceClass

An MBN_VOICE_CLASS value that specifies how voice calls are handled.

dataClass

A bitwise OR combination of MBN_DATA_CLASS values that specifies which data services are supported. For GSM devices, only the GSM-based data services can be present, that is, only GPRS, EDGE, UMTS, LTE, and HSDPA are valid values for GSM devices.

For CDMA devices, only the CDMA-related data services will be present, that is, only 1xRTT, 1xEV-DO, and 1xEV-DO RevA are valid values for CDMA devices. 1xEV-DO RevB is reserved for future use.

This field has the bit value MBN_DATA_CLASS_CUSTOM set if the data class some other data class which is not defined in the enumeration is also supported by device. If MBN_DATA_CLASS_CUSTOM is set then information regarding custom data class is available in customDataClass field.

customDataClass

Contains the name of the custom data class. If the MBN_DATA_CLASS_CUSTOM bit of dataClass is not set, then the string is NULL. Otherwise, the caller must free this string by calling SysFreeString.

gsmBandClass

A bit field that specifies the frequency bands supported by the GSM device. MBN_BAND_CLASS_I through MBN_BAND_CLASS_X and MBN_BAND_CLASS_CUSTOM are valid values. These values are defined by MBN_BAND_CLASS. If gsmBandClass is set to MBN_BAND_CLASS_CUSTOM, additional information about the band class appears in customBandClass.

The following table provides additional information about the MBN_BAND_CLASS values.

cdmaBandClass

A bit field that specifies the frequency bands supported by the CDMA device. MBN_BAND_CLASS_0 through MBN_BAND_CLASS_XVII, MBN_BAND_CLASS_NONE, and MBN_BAND_CLASS_CUSTOM are valid values. These values are defined by MBN_BAND_CLASS. If cdmaBandClass is set to MBN_BAND_CLASS_CUSTOM, additional information about the band class appears in customBandClass.

The following table provides additional information about MBN_BAND_CLASS values.

customBandClass

Contains the name of the custom band class. If the MBN_BAND_CLASS_CUSTOM bit of cdmaBandClass and gsmBandClass is not set, then the string is NULL. Otherwise, the caller must free this string by calling SysFreeString.

smsCaps

A bitwise OR combination of MBN_SMS_CAPS values that specifies the SMS capabilities.

controlCaps

A bitwise OR combination of MBN_CTRL_CAPS values that represents the Mobile Broadband control capabilities for this interface.

deviceID

Contains the device ID. For GSM devices, this must be the IMEI (up to 15 digits). For CDMA devices, this must be the ESN (11 digits) / MEID (17 digits). The maximum length of the string is MBN_DEVICEID_LEN. For the definition of MBN_DEVICEID_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

manufacturer

Contains the name of the device manufacturer. This string can be empty. The maximum length of the string is MBN_MANUFACTURER_LEN. For the definition of MBN_MANUFACTURER_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

model

Contains the device model. This string can be empty. The maximum length of this string is MBN_MODEL_LEN. For the definition of MBN_MODEL_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

firmwareInfo

Contains the firmware-specific information for this device. This string can be empty. The maximum length of the string is MBN_FIRMWARE_LEN. For the definition of MBN_FIRMWARE_LEN, see MBN_INTERFACE_CAPS_CONSTANTS. The caller must free this string by calling SysFreeString.

Requirements