Connecting To Com Objects; Setting Properties And Invoking Methods - MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX Develop Manual

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

Connecting to COM objects

The attribute of the
action
objects:
•
Create method
instantiates it prior to invoking methods and assigning properties.
•
Connect method
executable, that is already running on the server.
You can use the optional
specify a context, ColdFusion uses the setting in the Registry. The following table describes the
attribute values:
context
Attribute value
InProc
local
remote

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">
768 Chapter 34: Integrating COM and CORBA Objects in CFML Applications
method which has a number of optional arguments to send messages.
send
tag provides the following two ways to connect to COM
cfobject
(
cfobject action="Create"
(
cfobject action="Connect"
cfobject context
Description
An in-process server object (typically a DLL) that is running in the same
process space as the calling process, such as ColdFusion.
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.
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
attribute to identify where the object resides.
server
) Takes a COM object, typically a DLL, and
) Links to an object, typically an
attribute to specify the object context. If you do not