Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 1179

DEVELOPING COLDFUSION 9 APPLICATIONS
Using Web Elements and External Objects
Finding the component ProgID and methods
Your COM object supplier provides documentation that explains each of the component methods and the ProgID. If
you do not have documentation, use either the ColdFusion
component interface.
Using the cfdump tag to view COM object interfaces
Effective with ColdFusion, the ColdFusion
• Public methods
• Put properties
• Get properties
The method and property information include the parameter or property types and whether they are in, out, optional,
or retval values. The
cfdump
Note: The dump header indicates the ColdFusion object class, which is coldfusion.runtime.com.ComProxy, and the COM
object CLSID.
Using the OLE/COM Object Viewer
The OLE/COM Object Viewer installation installs the executable, by default, as \mstools\bin\oleview.exe. You use the
Object Viewer to retrieve a COM object ProgID, as well as its methods and properties.
To find an object in the Object Viewer, it must be registered, as described in
Object Viewer retrieves all COM objects and controls from the Registry, and presents the information in a simple
format, sorted into groups for easy viewing.
By selecting the category and then the component, you can see the ProgID of a COM object. The Object Viewer also
provides access to options for the operation of the object.
To view object properties:
Open the Object Viewer and scroll to the object that you want to examine.
1
2 Select and expand the object in the left pane of the Object Viewer.
Right-click the object to view it, including the TypeInfo.
3
If you view the TypeInfo, you see the object methods and properties. Some objects do not have access to the
TypeInfo area, which is determined when an object is built and by the language used.
Creating and using COM objects
Use the tag or the
cfobject
ColdFusion before your application pages can invoke any methods or assign any properties in the component.
For example, the following code uses the
NTS NewMail object to send mail:
<cfobject type="COM"
action="Create"
name="Mailer"
class="CDONTS.NewMail">
The following line shows how to use the corresponding
Mailer = CreateObject("COM", "CDONTS.NewMail");
tag displays the following information about a COM object:
cfdump
tag output does not include the ProgID of the object.
function to create an instance of the COM object (component) in
CreateObject
tag to create the Windows CDO (Collaborative Data Objects) for
cfobject
CreateObject
Last updated 1/20/2012
tag or the OLE/COM Object Viewer to view the
cfdump
"Registering the
function in CFScript:
1174
object" on page 1173. The