CFML Reference
|
|
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.
Return value
A COM object.
Syntax
CreateObject(type, class, context, serverName)
Parameters
Parameter |
Description |
type
|
Type of object to create.
- com
- corba
- java
- component
- webservice
|
class
|
Component ProgID for the object to invoke
|
context
|
|
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 would use this code within a cfscript
tag.
Mailer = CreateObject
("COM", "CDONTS.NewMail");
For more information, see Developing ColdFusion MX Applications with CFML.
Comments