Mobile Broadband

Overview of the Mobile Broadband technology.

To develop Mobile Broadband, you need these headers:

• mbnapi.h

For programming guidance for this technology, see:

• Mobile Broadband

Enumerations

MBN_ACTIVATION_STATE The MBN_ACTIVATION_STATE enumerated type indicates the current data connection state.
MBN_AUTH_PROTOCOL The MBN_AUTH_PROTOCOL enumerated type specifies the authentication protocol used for Packet Data Protocol (PDP) activation.
MBN_BAND_CLASS The MBN_BAND_CLASS enumerated type defines the frequency band classes.
MBN_CELLULAR_CLASS The MBN_CELLULAR_CLASS enumerated type defines the type of cellular device.
MBN_COMPRESSION The MBN_COMPRESSION enumerated type specifies whether compression is to be used in the data link for header and data.
MBN_CONNECTION_MODE The MBN_CONNECTION_MODE enumerated type specifies the mode of connection requested.
MBN_CONTEXT_CONSTANTS The MBN_CONTEXT_CONSTANTS enumerated type specifies the maximum string lengths supported by members of the MBN_CONTEXT structure.
MBN_CONTEXT_TYPE The MBN_CONTEXT_TYPE enumerated type specifies the represented context type.
MBN_CTRL_CAPS The MBN_CTRL_CAPS enumerated type represents all of the Mobile Broadband device control capabilities as bit fields.
MBN_DATA_CLASS The MBN_DATA_CLASS enumerated type specifies the data classes that a provider supports.
MBN_DEVICE_SERVICES_INTERFACE_STATE . (MBN_DEVICE_SERVICES_INTERFACE_STATE)
MBN_INTERFACE_CAPS_CONSTANTS The MBN_INTERFACE_CAPS_CONSTANTS enumerated type defines the maximum length of string values used by assorted elements of the MBN_INTERFACE_CAPS structure.
MBN_MSG_STATUS The MBN_MSG_STATUS enumerated type defines the type of message being handled.
MBN_PIN_CONSTANTS The MBN_PIN_CONSTANTS enumerated type defines constant values used by the MBN_PIN_INFO structure.
MBN_PIN_FORMAT The MBN_PIN_FORMAT enumerated type indicates whether a PIN is numeric or alphanumeric.
MBN_PIN_MODE The MBN_PIN_MODE enumerated type indicates if the PIN type is enabled.
MBN_PIN_STATE The MBN_PIN_STATE enumerated type indicates the current PIN state of the Mobile Broadband device.
MBN_PIN_TYPE The MBN_PIN_TYPE enumerated type indicates the type of password required for unlocking the information stored on the interface.
MBN_PROVIDER_CONSTANTS The MBN_PROVIDER_CONSTANTS enumerated type contains values that define the buffer lengths of MBN_PROVIDER members.
MBN_PROVIDER_STATE The MBN_PROVIDER_STATE enumerated type specifies the various states with which a provider entry can be tagged.
MBN_RADIO The MBN_RADIO enumerated type indicates whether the device radio is on or off.
MBN_READY_STATE The MBN_READY_STATE enumerated type contains values that indicate the readiness of a Mobile Broadband device to engage in cellular network traffic operations.
MBN_REGISTER_MODE The MBN_REGISTER_MODE enumerated type indicates the network selection mode of a device.
MBN_REGISTER_STATE The MBN_REGISTER_STATE enumerated type indicates the network registration state of a Mobile Broadband device.
MBN_REGISTRATION_CONSTANTS The MBN_REGISTRATION_CONSTANTS enumerated type contains specific values used by IMbnRegistration interface operations.
MBN_SIGNAL_CONSTANTS THE MBN_SIGNAL_CONSTANTS enumerated type contains specific values used by IMbnSignal interface operations.
MBN_SMS_CAPS The MBN_SMS_CAPS enumerated type contains bitfield values that specify SMS capabilities.
MBN_SMS_CDMA_ENCODING The MBN_SMS_CDMA_ENCODING enumerated type specifies character encoding types for CDMA.
MBN_SMS_CDMA_LANG The MBN_SMS_CDMA_LANG enumerated type represents the different languages that can be used in a CDMA message.
MBN_SMS_FLAG The MBN_SMS_FLAG enumerated type specifies the SMS message class.
MBN_SMS_FORMAT Format of SMS messages.
MBN_SMS_STATUS_FLAG The MBN_SMS_STATUS_FLAG enumerated type indicates the status of a device's SMS message store.
MBN_VOICE_CALL_STATE The MBN_VOICE_CALL_STATE enumerated type specifies the current voice call state of the device.
MBN_VOICE_CLASS The MBN_VOICE_CLASS enumerated type specifies a device's voice capabilities and how they interact with the data service.
WWAEXT_SMS_CONSTANTS The MBN_SMS_CONSTANTS enumerated type contains SMS constant values.

Functions

Activate Send the service activation request to the network.
Change Changes the PIN.
CloseCommandSession Closes a command session to a device service on a Mobile Broadband device.
CloseDataSession Closes the data session to a device service on a Mobile Broadband device.
Connect Establishes a data connection.
CreateConnectionProfile Creates a new connection profile for the device.
Delete Deletes the profile from the system.
Disable Disables a PIN.
Disconnect Disconnects a data connection.
Enable Enables a PIN.
Enter Enters a PIN.
EnumerateDeviceServices Gets the list of supported device services by the Mobile Broadband device.
get_Address The mobile number associated with a message.
get_CdmaShortMsgSize Maximum CDMA short message character length.
get_ConnectionID Gets the unique identifier for the connection.
get_DeviceServiceID The ID of the device service to which this object is associated.
get_EncodingID The data encoding used in the message.
get_HardwareRadioState The hardware radio state of a Mobile Broadband device.
get_Index The index of the message in the device SMS store.
get_Index The index of the message in device SMS memory.
get_InterfaceID Gets the interface identifier.
get_InterfaceID The interface ID of the Mobile Broadband device to which this object is associated.
get_InterfaceID The interface ID.
get_IsCommandSessionOpen Reports if the device service command session is open.
get_IsDataSessionOpen Reports if the device service data session is open.
get_LanguageID The language used in the message.
get_MaxCommandSize The maximum length, in bytes, of data that can be associated with a device service SET or QUERY command.
get_MaxDataSize The maximum length, in bytes, of data that can be written to or read from a device service session.
get_MaxMessageIndex SMS message memory capacity.
get_Message Message in WMT format as used by CDMA devices.
get_Message The contents of the message.
get_PduData The PDU message in hexadecimal format as used by GSM devices.
get_PinFormat The PIN format.
get_PinLengthMax The maximum length of the PIN.
get_PinLengthMin The minimum length of the PIN.
get_PinMode The PIN mode.
get_PinType The PIN type.
get_ServiceCenterAddress SMS default Service Center address. (Get)
get_SimIccID The SIM International circuit card number (SimICCID) for the device.
get_SizeInCharacters The size in characters of the message.
get_SmsFormat Format in which newly received SMS should be reported by the device. (Get)
get_SoftwareRadioState The software radio state of a Mobile Broadband device.
get_Status The type of message. (IMbnSmsReadMsgPdu.get_Status)
get_Status The type of message. (IMbnSmsReadMsgTextCdma.get_Status)
get_SubscriberID The subscriber ID of the device.
get_TelephoneNumbers The telephone numbers associated with the device.
get_Timestamp The timestamp of a message.
GetActivationNetworkError Gets the network error returned in a Packet Data Protocol (PDP) context activation failure.
GetAvailableDataClasses Gets the available data classes in the current network.
GetConnection Gets a connection.
GetConnection Gets the IMbnConnection object.
GetConnectionProfile Gets a specific connection profile associated with the given Mobile Broadband device.
GetConnectionProfiles Gets a list of connection profiles associated with the device.
GetConnections Gets a list of available connections.
GetConnectionState Gets the current connection state of the device.
GetCurrentCellularClass Gets the current cellular classes for a multi-carrier device.
GetCurrentDataClass Gets the current data class in the current network.
GetDeviceService Gets the IMbnDeviceService object that can be used for communicating with a device service on the Mobile Broadband device.
GetDeviceServicesContext Gets the IMbnDeviceServicesContext interface for a specific Mobile Broadband device.
GetHomeProvider Gets the home provider.
GetInterface Gets a specific interface.
GetInterfaceCapability Gets the capabilities of the device.
GetInterfaces Gets a list of all available IMbnInterface objects.
GetPacketAttachNetworkError Gets the network error from a packet attach operation.
GetPin Gets a specific type of PIN.
GetPinList Gets a list of different PIN types supported by the device.
GetPinManager Gets the IMbnPinManager.
GetPinState Gets the current PIN state of the device.
GetPreferredProviders Gets the list of preferred providers.
GetPreferredProviders Gets the list of subscribed providers visible in the current area for a multi-carrier device minus the current registered provider.
GetProfileXmlData Gets the XML data of the current profile.
GetProviderID Gets the provider ID for the currently registered network.
GetProviderName Gets the provider name for the currently registered network.
GetProvisionedContexts Gets a list of connection contexts.
GetReadyState Gets the ready state.
GetRegisterMode Gets the network registration mode of a Mobile Broadband device.
GetRegisterState Gets the registration state.
GetRegistrationNetworkError Gets the network error from a registration operation.
GetRoamingText Gets the roaming text describing the roaming provider.
GetSignalError Gets the received signal error rate.
GetSignalStrength Gets the signal strength received by the device.
GetSmsConfiguration Gets the SMS configuration of a device.
GetSmsStatus Gets the SMS status for a device.
GetSubscriberInformation Gets the subscriber information.
GetSupportedCellularClasses Gets the list of supported cellular classes for a multi-carrier device.
GetVisibleProviders Gets the list of visible providers.
GetVisibleProviders Gets the list of visible providers in the current area for a multi-carrier device minus preferred and registered providers.
GetVoiceCallState Gets the voice call state of the device.
InEmergencyMode Determines whether the device is in emergency mode.
OnActivationComplete Notification method called by the Mobile Broadband service to indicate that a service activation request ahs completed.
OnChangeComplete Notification method called by the Mobile Broadband service to indicate that a PIN change operation has completed.
OnCloseCommandSessionComplete Notification method indicating that a device service CloseCommandSession request has completed.
OnCloseDataSessionComplete Notification method indicating that a device service session CloseDataSession request has completed.
OnConnectComplete Notification method that signals the completion of a connection operation.
OnConnectionArrival Notification method that indicates a new connection was added to the system.
OnConnectionProfileArrival Notification method that indicates a new connection profile has been added to the system.
OnConnectionProfileRemoval Notification method that indicates a connection profile has been removed from the system.
OnConnectionRemoval Notification method that indicates a connection was removed from the system.
OnConnectStateChange Notification method that indicates whether the connection state of the device has changed.
OnCurrentCellularClassChange This notification method is called by the Mobile Broadband service to indicate the completion of a GetCurrentCellularClass operation.
OnDisableComplete Notification method called by the Mobile Broadband service to indicate that a PIN disable operation has completed.
OnDisconnectComplete Notification method that indicates that a disconnection operation has been performed.
OnEmergencyModeChange This notification method is called by the Mobile Broadband service to indicate that the emergency mode has changed.
OnEnableComplete Notification method called by the Mobile Broadband service to indicate that a PIN enable operation has completed.
OnEnterComplete Notification method called by the Mobile Broadband service to indicate that a PIN enter operation has completed.
OnEventNotification Notification method signaling a device service state change event from the Mobile Broadband device.
OnEventNotification Notification method signaling a change event from the underlying Mobile Broadband device miniport driver.
OnGetPinStateComplete Notification method called by the Mobile Broadband service to indicate the completion of an asynchronous operation triggered by a call to the GetPinState method of IMbnPinManager.
OnHomeProviderAvailable This notification method is called by the Mobile Broadband service to indicate that home provider information for the device is available.
OnInterfaceArrival Notification method that signals that a device has been added to the system.
OnInterfaceCapabilityAvailable This notification method is called by the Mobile Broadband service to indicate that interface capability information is available.
OnInterfaceCapabilityChange This notification method is called by the Mobile Broadband service to indicate the completion of a SetHomeProvider operation that updates the interface capabilities.
OnInterfaceRemoval Notification method that signals that a device has been removed from the system.
OnInterfaceStateChange Notification method that signals a change in the state of device services on the system.
OnOpenCommandSessionComplete Notification method indicating that a device service CommandSessionOpen request has completed.
OnOpenDataSessionComplete Notification method indicating that a device service OpenDataSession request has completed.
OnPacketServiceStateChange Notification method called by the Mobile Broadband service to indicate a change in the device packet service state.
OnPinListAvailable Notification method called by the Mobile Broadband service to indicate that the list of device PINs is available.
OnPreferredProvidersChange This notification method is called by the Mobile Broadband service to indicate a change in a device's preferred provider list.
OnPreferredProvidersChange This notification method is called by the Mobile Broadband service to indicate the completion of a GetPreferredProviders operation and a change in a device's preferred provider list.
OnProfileUpdate A notification method that indicates that profile update operation has completed.
OnProvisionedContextListChange Notification method called by the Mobile Broadband service to indicate that a provisioned context stored in the device is available or updated.
OnQueryCommandComplete Notification method indicating that a device service QUERY request has completed.
OnQuerySupportedCommandsComplete Notification method indicating that a query for the messages supported on a device service has completed.
OnRadioStateChange A notification signaling that the radio state of the device has changed.
OnReadData Notification for data being read from a device service data session.
OnReadyStateChange This notification method is called by the Mobile Broadband service to indicate a change in an interface's ready state.
OnRegisterModeAvailable Notification method called by the Mobile Broadband service to indicate that registration mode information is available.
OnRegisterStateChange Notification method called by the Mobile Broadband service to indicate a change in the device's registration state.
OnScanNetworkComplete This notification method is called by the Mobile Broadband service to indicate the completion of a network scan.
OnScanNetworkComplete This notification method is called by the Mobile Broadband service to indicate the completion of a ScanNetwork operation.
OnSetCommandComplete Notification method indicating that a device service SET request has completed.
OnSetHomeProviderComplete This notification method is called by the Mobile Broadband service to indicate the completion of a SetHomeProvider operation.
OnSetPreferredProvidersComplete This notification method is called by the Mobile Broadband service to indicate the completion of a SetPreferredProviders operation.
OnSetProvisionedContextComplete Notification method called by the Mobile Broadband service to indicate that the provisioned context in the device has been set.
OnSetRegisterModeComplete Notification method called by the Mobile Broadband service to indicate that it has completed a set registration operation.
OnSetSmsConfigurationComplete Notification method signaling that a set SMS configuration operation has completed, or that the SMS subsystem is initialized and ready for operation.
OnSetSoftwareRadioStateComplete Notification that a set software radio state operation has completed.
OnSetVendorSpecificComplete Notification method indicating that a vendor-specific operation has completed.
OnSignalStateChange This notification method is called by the Mobile Broadband service to indicate that a signal quality update is available.
OnSmsConfigurationChange Notification method that indicates that SMS configuration has changed or is available.
OnSmsDeleteComplete Notification method that signals the completion of an SMS deletion operation.
OnSmsNewClass0Message Notification method signaling the arrival of a new class 0/flash message.
OnSmsReadComplete Notification method indicating the completion of a message read operation.
OnSmsSendComplete Notification method that indicates the completion of a message send operation.
OnSmsStatusChange Notification method indicating a change in the status of the message store.
OnSubscriberInformationChange This notification method is called by the Mobile Broadband service to indicate that the subscriber information for the device has changed.
OnUnblockComplete Notification method called by the Mobile Broadband service to indicate that a PIN unblock operation has completed.
OnVoiceCallStateChange Notification method that indicates a change in the voice call state of a device.
OnWriteDataComplete Notification method indicating that a device service session Write request has completed.
OpenCommandSession Opens a command session to a device service on a Mobile Broadband device.
OpenDataSession Open a data session to the device service on a Mobile Broadband device.
put_ServiceCenterAddress SMS default Service Center address. (Put)
put_SmsFormat Format in which newly received SMS should be reported by the device. (Put)
QueryCommand Sends a QUERY control command to the device service of a Mobile Broadband device.
QuerySupportedCommands Gets the list of commands IDs supported by the Mobile Broadband device service.
ScanNetwork Asynchronously scans the network to get a list of visible providers.
ScanNetwork Scans the network to get a list of visible providers for a multi-carrier device.
SetCommand Sends a SET control command to the device service of a Mobile Broadband device.
SetHomeProvider Updates the home provider for a multi-carrier device.
SetPreferredProviders Updates the preferred providers list for the device.
SetProvisionedContext Adds or updates a provisioned context.
SetRegisterMode Sets the registration mode for the device.
SetSmsConfiguration Updates the SMS configuration for a device.
SetSoftwareRadioState Sets the software radio state of a Mobile Broadband device.
SetVendorSpecific Sends a request to the underlying Mobile Broadband device miniport driver.
SmsDelete Deletes a set of SMS messages from a device.
SmsRead Reads a set of SMS messages from a device.
SmsSendCdma Sends a message in CDMA format.
SmsSendCdmaPdu Sends a message in CDMA binary format.
SmsSendPdu Sends a message in PDU format.
Unblock Unblocks a blocked PIN.
UpdateProfile Updates the contents of the profile.
WriteData Write data to a device service data session.

Interfaces

IMbnConnection Represents the network connectivity of a device.
IMbnConnectionContext Manages connection contexts.
IMbnConnectionContextEvents This notification interface is used to handle asynchronous provisioned context events.
IMbnConnectionEvents This notification interface signals an application about change and completion status of asynchronous connection requests.
IMbnConnectionManager Provides access to IMbnConnection objects and connection notifications.
IMbnConnectionManagerEvents This notification interface signals an application about the arrival and removal of IMbnConnection interfaces in the system.
IMbnConnectionProfile This interface accesses connection parameters and preferences stored in Mobile Broadband profiles.
IMbnConnectionProfileEvents This notification interface signals an application when IMbnConnectionProfile methods change the Mobile Broadband profile state.
IMbnConnectionProfileManager Provides access to connection profiles and connection notifications.
IMbnConnectionProfileManagerEvents This notification interface signals an application about the arrival and removal of IMbnConnectionProfile interfaces in the system.
IMbnDeviceService Allows for communicating with a device service on a particular Mobile Broadband device.
IMbnDeviceServicesContext Allows for enumerating and retrieving Mobile Broadband device objects on the system.
IMbnDeviceServicesEvents Signals an application about notification events related to Mobile Broadband device services on the system.
IMbnDeviceServicesManager Provides access to IMbnDeviceServicesContext objects and Mobile Broadband device service notifications.
IMbnInterface Represents a Mobile Broadband device.
IMbnInterfaceEvents This interface is a notification interface used to handle asynchronous IMbnInterface method calls as well as changes in the device state.
IMbnInterfaceManager Provides access to IMbnInterface objects and notifications.
IMbnInterfaceManagerEvents This notification interface signals an application about the arrival and removal of devices in the system.
IMbnMultiCarrier This interface exposes the multi-carrier functionality of a capable Mobile Broadband device.
IMbnMultiCarrierEvents This interface is a notification interface used to handle asynchronous IMbnMultiCarrier method calls.
IMbnPin Represents the device PIN.
IMbnPinEvents This interface is a notification interface used to indicate when asynchronous PIN requests have completed.
IMbnPinManager Provides important details about the device PIN.
IMbnPinManagerEvents Notification interface used to indicate when PIN Manager events have occurred.
IMbnRadio The IMbnRadio interface is used to query and update the radio state of Mobile Broadband devices.
IMbnRadioEvents Notification interface used to indicate a change in the radio state as well as the completion of a programmatic change in the state .
IMbnRegistration Provides access to network registration data.
IMbnRegistrationEvents Notification interface used to indicate when registration events have occurred.
IMbnServiceActivation Pass-through mechanism for cellular service activation.
IMbnServiceActivationEvents This notification interface signals an application about the completion of a service activation request.
IMbnSignal Get radio signal quality of a Mobile Broadband connection.
IMbnSignalEvents Notification interface used to indicate that a signal event has occurred.
IMbnSms SMS interface for sending and receiving messages as well as controlling the messaging configuration.
IMbnSmsConfiguration Provides access to the SMS configuration of a device.
IMbnSmsEvents This notification interface signals an application with the completion status of SMS operations and changes in the device SMS status.
IMbnSmsReadMsgPdu A collection of properties that represent an SMS message read from the device memory.
IMbnSmsReadMsgTextCdma A collection of properties that represent a CDMA format SMS message read from the device memory.
IMbnSubscriberInformation Provides access to subscriber information.
IMbnVendorSpecificEvents This notification interface signals an application of the completion status of vendor-specific operations and other vendor-specific changes in the device state.
IMbnVendorSpecificOperation Interface to pass requests from an application to the underlying Mobile Broadband miniport drivers.

Structures

MBN_CONTEXT The MBN_CONTEXT structure stores information about the connection context.
MBN_DEVICE_SERVICE The MBN_DEVICE_SERVICE structure provides information about a Mobile Broadband device service.
MBN_INTERFACE_CAPS The MBN_INTERFACE_CAPS structure represents the interface capabilities.
MBN_PIN_INFO The MBN_PIN_INFO structure represents the current PIN state of the device.
MBN_PROVIDER The MBN_PROVIDER structure represents a network service provider.
MBN_PROVIDER2 The MBN_PROVIDER2 structure represents a network service provider. It is used by many of the provider-specific methods of the IMbnMultiCarrier interface and provides an extension to MBN_PROVIDER to support multi-carrier.
MBN_SMS_FILTER The MBN_SMS_FILTER structure contains the values that describe a set of SMS messages.
MBN_SMS_STATUS_INFO The MBN_SMS_STATUS_INFO structure contains the status of the SMS message store of a device.