DLL val_SetMaxAttempts

DLL access EmailCmd Example

Purpose: Sets the maximum attempts to be made during val_SendMessage operations.

Handle: The unique ID identifying the email object

Operator: val_SetMaxAttempts = 18

Data: String data type holding an integer number of attempts.

Returns: Success or Error Status

IMPORTANT: The Data argument for this operator must be a string data type. But, for this operator, the information contained in the string must be the string representation of a positive integer number. Seventy-two would be given as the Javascript string "72".

This operator sets the maximum allowed attempts to be made during the val_SendMessage operation. Transmitting the message must pass through three phases: connecting, transmitting, and disconnecting. If an error occurs during any of those phases, the phase will be retried, but only the number of times you specify with this operator. If that number of tries is exceeded without achieving success, the message send operation will be aborted, and an error message returned.

The default value for this is three. If you do not use this operator, the default value will be used. Note that the default value is set in the DLL-based email object when the val_NewEmail operator is called.