User Guide

424 Chapter 3: ColdFusion Functions
CreateObject: COM object
Description
The CreateObject function can create a Component Object Model (COM) object.
To create a COM object, you must provide this information:
• The object’s program ID or filename
• The methods and properties available to the object through the IDispatch interface
• The arguments and return types of the object's methods
For most objects, you can get this information from the OLEView utility.
Note: On UNIX, this function does not support COM objects.
Returns
A COM object.
Function syntax
CreateObject(type, class, context, serverName)
See also
ReleaseComObject, cfobject
Parameters
Usage
The following example creates the Windows Collaborative Data Objects (CDO) for NTS
NewMail object to send mail. You would use this code within a
cfscript tag.
Mailer = CreateObject("COM", "CDONTS.NewMail");
For more information, see Chapter 34, “Integrating COM and CORBA Objects in CFML
Applications,” in Developing ColdFusion MX Applications.
Parameter Description
type Type of object to create.
• com
• corba
• java
• component
• webservice
class Component ProgID for the object to invoke
context • InProc
• Local
• Remote
serverName Server name, using UNC or DNS convention, in one of these forms:
• \\lanserver
• lanserver
• http://www.servername.com
• www.servername.com
• 127.0.0.1
If
context = "remote", this parameter is required.