Creating And Using Com Objects; Connecting To Com Objects - MACROMEDIA COLDFUSION 5-DEVELOPING Develop Manual

374

Creating and Using COM Objects

The following example uses
Objects) for NTS NewMail object to send mail.
<cfobject type="COM"
Note
CDO is installed by default on all Windows NT and 2000 operating systems that have
installed the Microsoft SMTP server. In Windows NT Server environments, the SMTP
server is part of the Option Pack 4 set up. In Windows 2000 Server and Workstation
environments, it is bundled with the operating system. For more information on
CDO for NTS, see http://msdn.microsoft.com/library/default.asp?URL=/library/
psdk/cdo/_olemsg_overview_of_cdo.htm.
You must create the component in ColdFusion before your application pages can
invoke any methods or assign any properties in the component. This sample 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 Viewer, methods and
properties might be grouped together, so you might find it difficult to distinguish
between them at first.)
The CDO for NTS NewMail object includes the following properties:
Body [ string ]
Cc
From
Importance
Subject
To
You use these properties to define elements of the mail message you want to send.
The CDO for NTS NewMail object also includes a method with a number of optional
arguments to send messages:
Send()

Connecting to COM objects

The
You can also use the
specify a context, ColdFusion uses the setting in the registry.
action="Create"
name="Mailer"
class="CDONTS.NewMail">
[ String ]
[ String ]
[ Long ]
[ String ]
[ String ]
attribute of
action cfobject
Create method (
cfobject action="Create
DLL, and instantiates it prior to invoking methods and assigning properties.
Connect method (
cfobject action="Connect"
already running on the server, typically an executable.
context
An in-process server object (typically a DLL) that is running in the same
InProc
process space as the calling process, such as ColdFusion.
Chapter 20 Using cfobject to Invoke Component Objects
to create the CDO (Collaborative Data
cfobject
provides two ways to connect to COM objects:
") Takes a COM object, typically a
attribute to specify the object context. If you do not
) Links to an object that is