SMSNext (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Reading and deleting the SMS messages on a Smartphone
Differences between GO mode and run time
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SMSNext (Function)

In french: SMSSuivant

Reads the next SMS:

in the memory of Pocket PC or Smartphone (the executable must be signed).
Versions 15 and later
in the memory of Android phone.
New in version 15
in the memory of Android phone.
in the memory of Android phone.
in the SIM card of Pocket PC or Smartphone.

The characteristics of this SMS are contained in the SMS structure.

Versions 15 and later

This function is now available for Android applications.

Only SMS messages found in the phone memory can be handled by the SMS functions.

New in version 15

This function is now available for Android applications.

Only SMS messages found in the phone memory can be handled by the SMS functions.

This function is now available for Android applications.

Only SMS messages found in the phone memory can be handled by the SMS functions.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Example

// Number of SMSs stored on the SIM card
STC_NbSMS = "You have " + SMSNbMessage(smsSIM) + " messages."

// Read the first SMS stored on the SIM card
ResRead is boolean = SMSFirst(smsSIM)

WHILE ResRead = True
// Display the characteristics of this SMS in a table :
// the SMS variable is automatically updated
TableAddLine(TABLE_SMSTable, SMS.Subscript, SMS.Message, SMS.Number, SMS.ReceiveDate)
// Read the other SMSs
ResRead = SMSNext(smsSIM)
END

Syntax

<Result> = SMSNext(<Location>)

<Result>: Boolean

True if the SMS was read. SMS.ReceiveDate, SMS.Subscript, SMS.Message, SMS.Number and SMS.NumberType are automatically filled. See the SMS structure for more details.
False otherwise. To find out the name of the error, use the function ErrorInfo with the constant errMessage.

<Location>: Integer constant

Location of SMS to read:
smsMemory SMS stored in the device memory.
smsSIM SMS stored in the SIM card.
This constant is not allowed and it triggers a fatal error.

Remarks

Reading and deleting the SMS messages on a Smartphone

To read and/or delete SMS messages on a Smartphone (functions SMSNbMessage, SMSFirst, SMSNext or SMSDelete), the executable of the WINDEV Mobile application and its framework (WINDEV Mobile libraries) must be electronically signed.. A certificate is required to perform this operation.

Remark: If the executable is not signed, only the SMS of SIM card can be read.

Differences between GO mode and run time

In GO mode (simulation on the development computer), a WLanguage error is generated during the call to SMSNext.

The differences between GO mode (simulator) and runtime are presented in Differences between GO mode and runtime.

The SMS functions can be used during a GO on the Android emulator. To simulate the sending of SMS messages to the emulator, see the documentation of the Android SDK : https://developer.android.com/studio/run/emulator#console

Required permissions

The call to this function modifies the permissions required by the application.

Required permission : READ_SMS

Component : wp260com.dll