DLL val_FreeEmail

DLL access EmailCmd Example

Purpose: Destroys the email object in the DLL, and frees the memory space.

Handle: The unique ID identifying the email object

Operator: val_FreeEmail = 20

Data: Ignored; pass an empty string

Returns: Success or Error Status

This operator disposes of the DLL-based memory used by the identified email object. You should remember to use this operator, since memory leaks and problems sending email may result if the DLL memory is not freed. Also, be sure all use of the email object is completed before you call this operator. If you use the val_NewEmail operator supplying a handle that is already in use, you will receive an error. However, if you ignore that error and make use of that email object anyway, you may corrupt one or both email messages.