MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE, Reference

Page: 168 / 608

144 CFML Language Reference
CFOBJECT Type="COM"
CFOBJECT allows you to create and use COM (Component Object Model) objects. Any
automation server object type that is currently registered on a machine can be
invoked. You can use a utility like Microsoft’s OLEView to browse COM objects.
OLEView, as well as information about COM and DCOM, can be found at Microsoft’s
OLE Development web site http://www.microsoft.com/oledev/.
To use CFOBJECT, you need to know the program ID or filename of the object, the
methods and properties available through the IDispatch interface, and the arguments
and return types of the object’s methods. The OLEView utility can give you this
information for most COM objects.
Syntax
<CFOBJECT TYPE="COM"
ACTION="action"
CLASS="program_ID"
NAME="text"
CONTEXT="context"
SERVER="server_name">
ACTION
Required. One of the following:
•
Create — Use Create to instantiate a COM object (typically a DLL) prior to
invoking methods or properties.
•
Connect — Use Connect to connect to a COM object (typically an EXE) that is
already running on the server specified in SERVER.
CLASS
Required. Enter the component ProgID for the object you want to invoke.
NAME
Required. Enter a name for the object.
CONTEXT
Optional. InProc, Local, or Remote. Uses Registry setting when not specified.
SERVER
Required when CONTEXT="Remote". Enter a valid server name using UNC
(Universal Naming Convention) or DNS (Domain Name Server) conventions, in
one of the following forms:
SERVER="\\lanserver"
SERVER="lanserver"
SERVER="http://www.servername.com"
SERVER="www.servername.com"
SERVER="127.0.0.1"