IMbnSms::GetSmsStatus method (mbnapi.h)

Gets the SMS status for a device.

Syntax

HRESULT GetSmsStatus(
  [out] MBN_SMS_STATUS_INFO *smsStatusInfo
);

Parameters

[out] smsStatusInfo

A pointer to a MBN_SMS_STATUS_INFO structure, containing the status information for the device.

Return value

This method can return one of these values.

Remarks

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.

Requirements

See also

IMbnSms