Name
ReleaseCOMObject
Synopsis
ReleaseCOMObject(object)
Terminates any connections to the specified COM object and returns
any resources (such as RAM) to the server.
ReleaseComObject()
should only be used once you
have finished with the COM object. Many COM objects have a method you
can call to explicitly close the connection to the object, typically
close()
or quit()
. While this
method explicitly tells ColdFusion to terminate the connection to the
COM object, it does not immediately release the resources it was
consuming. It still has to wait for the garbage collection to occur.
ReleaseCOMObject()
is designed to get around this.
If you call the function while the COM object is still in use,
ColdFusion throws an exception. Example:
<cfset ReleaseComObject(myObject)>
Or:
<cfscript> ReleaseComObject(myObject); </cfscript>
Get Programming ColdFusion MX, 2nd Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.