DLL val_SendMessage

DLL access EmailCmd Example

Purpose: Transmits the email message to the host

Handle: The unique ID identifying the email object

Operator: val_SendMessage = 17

Data: Ignored; pass an empty string

Returns: Success or Error Status

This operator is the one that does the work. It takes no parameters in the Data argument, and returns the standard integer status. The status returned can include not only errors caused by missing information (no From Address), but also pesky winsock errors and SMTP protocol errors.

When attempting to send the email message, if problems occur while connecting to the server, sending the message, or disconnecting from the server, the number of attempts you set with the val_SetMaxAttempts operator are performed for each step. If the task can't be successfully completed after that, then the EmailCmd function gives up, and returns the appropriate error value.