| UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:mbnapi.IMbnSms.GetSmsStatus |
IMbnSms::GetSmsStatus (mbnapi.h) |
Gets the SMS status for a device. |
|
mbn\imbnsms_getsmsstatus.htm |
mbn |
58cb60dd-160c-4e1c-a244-7f20b5e79b64 |
12/05/2018 |
GetSmsStatus, GetSmsStatus method [Microsoft Broadband Networks], GetSmsStatus method [Microsoft Broadband Networks],IMbnSms interface, IMbnSms interface [Microsoft Broadband Networks],GetSmsStatus method, IMbnSms.GetSmsStatus, IMbnSms::GetSmsStatus, mbn.imbnsms_getsmsstatus, mbnapi/IMbnSms::GetSmsStatus |
mbnapi.h |
Windows |
Windows 7 [desktop apps only] |
None supported |
Mbnapi.idl |
Windows |
19H1 |
|
|
|
|
|
|
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.
Gets the SMS status for a device.
A pointer to a MBN_SMS_STATUS_INFO structure, containing the status information for the device.
This method can return one of these values.
| Return code | Description |
|---|---|
|
The method completed successfully. |
|
The SMS status is not available. The Mobile Broadband service is probing the device for the information. The calling application can be notified when the SMS status is available by registering for the OnSmsStatusChange method of the IMbnSmsEvents interface. |
|
A PIN is required to get this information. |
|
A SIM is not inserted in the device. |
|
A bad SIM is inserted in the device. |
For recoverable errors such as E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED, and E_MBN_BAD_SIM, the Mobile Broadband service will query the device again for this information when error condition is over. For example, if the device required a PIN to be entered to retrieve this information then it will return E_MBN_PIN_REQUIRED. When an application enters the PIN to unlock the device then the Mobile Broadband service will again try to get this information from the device. The Mobile Broadband service will call the OnSmsStatusChange method of the IMbnSmsEvents interface
The SMS Message store status can change because of new message received by the system. On any change in the message store status, the Mobile Broadband service will call the OnSmsStatusChange method of the IMbnSmsEvent interface.
Application issued operations such as the reading or deleting of messages may reset flag in MBN_SMS_STATUS_INFO structure. A change in the SMS store caused by this reset will not result in the calling of any notification method.