Adobe ColdFusion 8

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; "Integrating COM and CORBA Objects in CFML Applications" in the ColdFusion Developer's Guide

Parameters

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.

Usage

The following example creates the Windows Collaborative Data Objects (CDO) for NTS NewMail object to send mail. You use this code in a cfscript tag.

Mailer = CreateObject("COM", "CDONTS.NewMail");