DLL val_NewEmail

DLL access EmailCmd Example

Purpose: Create a new email object in the DLL

Handle: The unique ID identifying the email object

Operator: val_NewEmail = 1

Data: Ignored; pass an empty string

Returns: Success or Error Status

This operator instructs the DLL to dynamically create the email client object. the object is identified by the Handle provided by the caller. You must use this operator before you can make use of the object.

IMPORTANT: The calling program supplies the handle. Be sure to supply a unique value that will be different between every user session at minimum. For applications that require multiple DLL-based email objects to exist at one time, you must supply a handle value that is unique not only among each of the objects in the single session, but also among all the sessions running on the IntraBuilder server. Note, if you have multiple applications using the Email DLL, you will have to ensure that all of the Handles are unique, even among applications.

IMPORTANT: If you attempt to create multiple email objects having the same handle, using the val_NewEmail operator, you will receive an error indicating the handle is in use. Do not ignore this result. If you proceed to utilize that handle, you will definitely interfere with the other user of that email object. The DLL has no good way, except for the Handle value, to know which email object is owned by which process. Therefore, any operator that presents a valid handle is given completely unfettered access and control over the email object, regardless of whether it has any right to use that handle.