SMTPit_Clear

Description

The SMTPit_Clear function clears all values that have been set with the External Functions. This allows you to send a new message without any lingering values.

However, you can also clear only specific values and thus specifically use values from the last message.

Note: You can also set SMTPit Pro to clear specific fields on the "After Send" tab under the "Extras" tab in the Configuration Dialog.

Return Type

Text

Format

SMTPit_Clear ( Items )

Optional Parameters

• Items
  

  A Paragraph Mark- or Return-Separated list of items to Clear. (Leave off this parameter to clear everything.) Values you can use for this parameter include: "Host", "Port", "Authentication", "Tos", "CCs", "BCCs", "From", "Reply-To", "Subject", "Priority", "Email Headers", "Text Body", "Text Header", "Text Footer", "HTML Body", "HTML Header", "HTML Footer", "HTML Images", and "Attachments". Additionally, you can use "Connection-Related" to clear all connection-related values, "Recipients" to clear all recipient values, "Text" to clear all body text values, and "HTML" to clear all HTML-related values.

Examples

Example 1

Code:

SMTPit_Clear

Result:

Clears all values used in the last email message.

Example 2

Code:

SMTPit_Clear("Tos")

Result:

Clears the "To" email addresses from the last email message.

Example 3

Code:

SMTPit_Clear("To¶Subject")

Result:

Clears the "To" and "Subject" values from the last email message.