User Guide Cancel

CreateObject: COM object

 

Note:

As of ColdFusion (2021 release), CORBA has been removed. You can no longer use CORBA-related features, functions, and tags.

Description

The CreateObject function can create a Component Object Model (COM) object. To create a COM object, provide the following 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.

    On UNIX, this function does not support COM objects.

Returns

A COM object.

Function syntax

CreateObject(type, class, context, serverName)
CreateObject(type, class, context, serverName)
CreateObject(type, class, context, serverName)

See also

ReleaseComObjectcfobjectIntegrating COM and CORBA Objects in CFML Applications in the Developing ColdFusion Applications

Parameters

Parameter

Description

type

Type of object to create.

  • com
  • corba
  • java
  • component
  • webservice
    The default value of type is component.

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");
Mailer = CreateObject("COM", "CDONTS.NewMail");
Mailer = CreateObject("COM", "CDONTS.NewMail");

Get help faster and easier

New user?