MACROMEDIA ColdFusion MX, Develop Manual

Page: 768 / 860

768 Chapter 34: Integrating COM and CORBA Objects in CFML Applications
The CDO for NTS NewMail component includes a number of methods and properties to
perform a wide range of mail-handling tasks. (In the OLE/COM Object Viewer, methods and
properties might be grouped together, so you could find it difficult to distinguish between them
at first.)
The CDO for NTS NewMail object includes the following properties:
Body [ String ]
Cc [ String ]
From [ String ]
Importance [ Long ]
Subject [ String ]
To [ String ]
You use these properties to define elements of your mail message. The CDO for NTS NewMail
object also includes a
send
method which has a number of optional arguments to send messages.
Connecting to COM objects
The
action
attribute of the
cfobject
tag provides the following two ways to connect to COM
objects:
•
Create method
(
cfobject action="Create"
) Takes a COM object, typically a DLL, and
instantiates it prior to invoking methods and assigning properties.
•
Connect method (
cfobject action="Connect"
) Links to an object, typically an
executable, that is already running on the server.
You can use the optional
cfobject context
attribute to specify the object context. If you do not
specify a context, ColdFusion uses the setting in the Registry. The following table describes the
context
attribute values:
Setting properties and invoking methods
The following example, which uses the sample Mailer COM object, shows how to assign
properties to your mail message and how to execute component methods to handle mail
messages.
In the example, form variables contain the method parameters and properties, such as the name
of the recipient, the desired e-mail address, and so on:
<!--- First, create the object --->
<cfobject type="COM"
action="Create"
name="Mailer"
class="CDONTS.NewMail">
Attribute value Description
InProc An in-process server object (typically a DLL) that is running in the same
process space as the calling process, such as ColdFusion.
local An out-of-process server object (typically an EXE file) that is running
outside the ColdFusion process space but running locally on the same
server.
remote An out-of-process server object (typically an EXE file) that is running
remotely on the network. If you specify
remote , you must also use the
server
attribute to identify where the object resides.