Property name: |
Version (read-only) |
Property description: |
Returns the DLL's version and revision as a string. |
Examples: |
in ASP:
Response.Write(SMSMaker.Version)
|
in VB:
|
Property name: |
AppPath (read-only) |
Property description: |
Returns the DLL's complete path. |
Examples: |
in ASP:
Response.Write(SMSMaker.AppPath)
|
in VB:
|
Property name: |
isRunning (read-only) |
Property description: |
Returns, if SMS-Maker is running on your machine or the remote host. The application
writes an entry in the INI file when launched and terminated. This way, the ActiveX component
can determine if SMS-Maker is currently running. |
Example: |
if SMSMaker.isRunning then
...
end if
|
|
Property name: |
RegisteredName (read-only) |
Property description: |
Returns the registrant's name. |
Example: |
MsgBox SMSMaker.RegisteredName
|
|
Property name: |
RegisteredEMail (read-only) |
Property description: |
Returns the registrant's eMail address. |
Example: |
Response.Write("If you have problems sending SMS messages, contact us at " & SMSMaker.RegisteredName)
|
|
Property name: |
ExpirationDate (read-only) |
Property description: |
Returns the expiration date of SMS-Maker. |
Example: |
Debug.Print SMSMaker.ExpirationDate
|
|
Property name: |
INI |
Property description: |
Returns or sets the INI file the DLL uses to read and save program settings.
This is useful, if the DLL is saved in a different folder (or on a different computer) than
the application. By changing this, you can point the DLL to the INI file the program is using
and change the settings. For changing this value, use a complete local or UNC path. |
Example: |
SMSMaker.INI = "C:\Programs\SMSMaker\SMSMaker.ini"
Response.Write(SMSMaker.INI)
|
|
Property name: |
OutgoingDirectory |
Property description: |
Returns or sets the outgoing directory. In this directory all SMS files will be
saved and the application will check this folder and send all files found here. Use complete
local or UNC path to change it. |
Example: |
SMSMaker.OutgoingDirectory = "\\Server\C$\Programs\SMSMaker\Out"
Response.Write(SMSMaker.OutgoingDirectory)
|
|
Property name: |
isSending |
Property description: |
This property returns or sets the status of the application concerning automatic SMS sending.
Return values are 'TRUE' for sending is active (application is checking the outgoing directory
for new SMS messages to be send) or 'FALSE'.
To set this value, use '1' for activating, and '0' for deactivating SMS transactions. |
Example: |
X = SMSMaker.isSending
SMSMaker.isSending = 1
|
|
Property name: |
Port |
Property description: |
Returns or sets the COM port the application will use for connecting to the cellphone. |
Example: |
Response.write(SMSMaker.Port)
SMSMaker.Port = 2
|
|
Property name: |
Speed |
Property description: |
Sets or returns the baudrate used by the application to talk to the connected cellphone.
To set this value, use only standard baudrates (2400, 4800, 9600, 14400, 19200, 38400, 57600). |
Example: |
MsgBox SMSMaker.Speed
SMSMaker.Speed = 19200
|
|
Property name: |
ServiceCenter |
Property description: |
Returns or sets the phone number of the provider's service center. Use
international format or local number with leading 0 (before area code), no dashes, spaces or
(back)slashes. |
Example: |
SMSMaker.ServiceCenter = "+49170760000"
Response.Write(SMSMaker.ServiceCenter)
|
|
Property name: |
addEmptySCNumber |
Property description: |
Some providers need a ’00’ instead of no service center number
(only in PDU mode). This property returns or sets, if an empty SC number is included in messages
or not. Use '1' to set it or '0' to ommit it. |
Example: |
If SMSMaker.addEmptySCNumber Then MsgBox "Empty Number will be send."
SMSMaker.addEmptySCNumber = 1
|
|
Property name: |
logSMS |
Property description: |
Returns or sets, if SMS transactions will be logged or not. Returns TRUE or FALSE.
Use '1' or '0' to set it. |
Example: |
Response.Write(SMSMaker.logSMS)
SMSMaker.logSMS = 0
|
|
Property name: |
OutTiming |
Property description: |
Returns or sets the interval for checking the outgoing SMS directory for new
messages (in seconds). |
Example: |
SMSMaker.OutTiming = 30
...
Response.Write("Your message will be send in between the next " & SMSMaker.OutTiming & " seconds.")
|
|
Method name: |
CreateSMS(strRcpNumber, strMessageText [, strSMSFileName]) |
Method description: |
This is the method you're looking for ;-)) It creates an SMS file in your outgoing
folder. |
Method parameters: |
STRING strRcpNumber: The recipient's phone number
STRING strMessageText: The text of your message (max. 160 Characters)
optional STRING strFileName: Name of SMS file to save the message to. If no name is given,
this method will create one from the date and time of the message. File extension must be .SMS,
if no filename is given, it will be added.
|
Return value: |
TRUE or FALSE.
|
Examples: |
X = SMSMaker.CreateSMS("+491707331128", "This is a test")
Y = SMSMaker.CreateSMS("+491707331128", "Another test", "test.sms")
|
|
Method name: |
SaveChanges |
Method description: |
This method saves all changed settings. With this method, you can permanently
save any settings remotely from your application or web page. All changes will take effect
immediately in SMS-Maker application. If you make any changes while using an instance of the
SMSFile class and don't call this method, your changes will be lost after destroying it. |
Method parameters: |
none |
Return value: |
none |
Example: |
Call SMSMaker.SaveChanges
|
|
Err. No. |
Err. Message |
Err. description |
1 |
<INI file> not found |
The specified INI file for application and DLL was not found. It's
either not in the same directory as the DLL or you made a mistake when setting it. Check your
path and filename and set the property <obj>.INI again. |
2 |
COM port not found |
The COM port is net set in the INI file. Use property <obj>.Port
to set it. |
3 |
COM Speed not found |
There's no baudrate set in INI file. Use property <obj>.Speed
to set it. |
200 |
No number: Recipient number is empty |
This happens if you want to create an SMS file and idn't supply a
recipient number. |
201 |
No text: Message text is empty |
When saving an SMS file, you forgot to supply a message text. |
202 |
Invalid format: Recipient number must start with '+' or '0' |
The recipient's number format is wrong. You must use international
format, for example +491707331128 or local format with a leading zero, like 01707331128. |
203 |
Invalid format: Recipient number can't contain spaces, dashes or (back)slashes |
The recipient's number format is wrong. Don't use spaces, dashes or slashes. |
204 |
Message too long: Max. 160 characters for text to be send |
The message text is too long, max. allowed is 160 characters. |
205 |
Wrong file extension: Use '.sms' only. |
The filename extension supplied is wrong. SMS-Maker accepts .sms only. |