SMSNbMessage (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

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

SMSNbMessage (Function)

In french: SMSNbMessage

Returns the number of SMSs stored or the maximum number of SMSs that can be stored:

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.

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:
// 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> = SMSNbMessage(<Location> , <Type of information>)

<Result>: Integer

Number of SMSs stored or number of SMSs that can be stored,
-1 if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.

<Location>: Integer constant

Location of SMSs:
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.

<Type of information>: Integer constant

Requested type of information:
smsTotalNb Number of stored SMSs
smsNbUsed Maximum number of SMSs that can be stored
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 SMSNbMessage.

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