PHP Manual
COM 函数
Returns a handle to an already running instance of a COM object

com_get_active_object

(PHP 5, PHP 7)

com_get_active_object — Returns a handle to an already running instance of a COM object

说明

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

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.

参数

progid: progid must be either the ProgID or CLSID for the object that you want to access (for example Word.Application).
code_page: Acts in precisely the same way that it does for the COM class.

返回值

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

错误／异常

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 MK_E_UNAVAILABLE; you can use the getCode method of the exception object to check the exception code.

注释

Warning

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.

php com 函数 returns a handle to an already running instance of a com object php ibm db2 函数 returns an object with properties that describe the db2 database server php hyperwave api 函数 returns object of class hw api php hyperwave api 函数 creates a new instance of class hwapi object new php mailparse 函数 returns a handle on a given section in a mimemessage php maxdb 函数 returns the current row of a result set as an object php oci8 函数 returns the next row from a query as an object php spl 函数 return the integer object handle for given object php sqlite 函数 opens an sqlite database and returns an sqlitedatabase object php com 函数 returns a variant date representation of a unix timestamp php com 函数 returns the result from dividing two variants php com 函数 returns the integer portion of a variant php com 函数 returns the type of a variant object php com 函数 converts variants to integers and then returns the result from dividing them php com 函数 returns the integer portion of a variant php com 函数 divides two variants and returns only the remainder php com 函数 assigns a new value for a variant object php hyperwave api 函数 returns source of a destination object php sdo das xml 函数 returns sdo das xml document object for a given path to xml instance document php sdo das xml 函数 returns sdo das xml document for a given xml instance string