|
com_get_active_objectReturns a handle to an already running instance of a COM object Description
variant com_get_active_object(string
$prog_id , intnull $codepage = null )
com_get_active_object is similar to creating a new
instance of a com object, except that it will
only return an object to your script if the object is already running.
OLE applications use something known as the " Parameters
Return ValuesIf the requested object is running, it will be returned to your script just like any other COM object. Errors/Exceptions
There are a variety of reasons why this function might fail, the most
common being that the object is not already running. In that situation,
the exception error code will be Changelog
NotesWarning
Using com_get_active_object in a web server context is not always a smart idea. Most COM/OLE applications are not designed to handle more than one client concurrently, even (or especially!) Microsoft Office. You should read » Considerations for Server-Side Automation of Office for more information on the general issues involved. |