SMSFirst (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Reading and deleting the SMSs found on a Smartphone
Differences between GO mode and run time
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SMSFirst (Function)

In french: SMSPremier

Reads the first SMS stored:

in the memory of the Mobile Device (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 the Mobile Device (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 the SMSs 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 the SMSs found in the phone memory can be handled by the SMS functions.

This function is now available for Android applications.

Only the SMSs 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 control:
// 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> = SMSFirst(<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 error details, use ErrorInfo associated with the errMessage constant.

<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 SMSs found on a Smartphone

To read and/or delete the SMSs found on a Smartphone (SMSNbMessage, SMSFirst, SMSNext or SMSDelete), the executable of WINDEV Mobile application as well as its framework (WINDEV Mobile libraries) must be digitally 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.

Versions 16 and later
To sign the executable, all you have to do is specify the certificate that will be used in the wizard for creating the mobile executable. See Creating an executable for more details.

New in version 16
To sign the executable, all you have to do is specify the certificate that will be used in the wizard for creating the mobile executable. See Creating an executable for more details.

To sign the executable, all you have to do is specify the certificate that will be used in the wizard for creating the mobile executable. See Creating an executable for more details.

Differences between GO mode and run time

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

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

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 : wp250com.dll