(PHP 5, PHP 7, PHP 8)
com_get_active_object — Devuelve un objeto que representa la instancia actual de un objeto COM
com_get_active_object() es similar a la creación de una
nueva instancia com de un objeto COM, excepto que solo
devolverá un objeto al script si el objeto está actualmente instanciado. Las aplicaciones OLE utilizan algo conocido como
"Running Object Table
" que permite a las aplicaciones conocidas
ser ejecutadas solo una vez; esta función expone la función
GetActiveObject() de la biblioteca COM para recuperar un objeto de una instancia en uso.
prog_id
El parámetro prog_id
debe ser el ProgID o el
CLSID del objeto al que se desea acceder (por ejemplo,
Word.Application
).
codepage
utiliza las mismas reglas que en la com clase.
Si el objeto solicitado está en ejecución, la función devolverá al script lo que cualquier otro objeto COM devolvería.
Hay muchas razones por las cuales esta función puede fallar. En
esta situación, el código de error de la excepción debería ser
MK_E_UNAVAILABLE
; se puede utilizar el método
getCode
del objeto excepción para verificar el código de la excepción.
Versión | Descripción |
---|---|
8.0.0 |
codepage es ahora nullable.
|
Utilizar la función com_get_active_object() en un servidor web no siempre es la mejor idea. La mayoría de las aplicaciones COM/OLE no están diseñadas para manejar más de un cliente concurrente, como (¡¡y especialmente!!) Microsoft Office. Se debe leer las » consideraciones para los automatismos lado-servidor para Office para obtener más información sobre los comportamientos generales.