Mobile Broadband
Overview of the Mobile Broadband technology.
To develop Mobile Broadband, you need these headers:
For programming guidance for this technology, see:
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. |
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for