com_get_active_object

Example

 variant com_get_active_object ( string $progid [, int $code_page ] ) 

Description

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 Running Object Table to allow well-known applications to be launched only once; this function exposes the COM library function GetActiveObject() to get a handle on a running instance.

Return Values

If the requested object is running, it will be returned to your script just like any other COM object.