com_get_active_object

com_get_active_object

Devuelve un objeto que representa la instancia actual de un objeto COM

Descripción#

php com_get_active_object(string $prog_id, [int $codepage]): variantphp

com_get_active_object es similar a la creación de una nueva instancia ??? 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.

Parámetros#

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 ??? clase.

Valores devueltos#

Si el objeto solicitado está en ejecución, la función devolverá al script lo que cualquier otro objeto COM devolvería.

Errores/Excepciones#

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.

Historial de cambios#

Versión	Descripción
8.0.0	codepage es ahora nullable.

Notas#

[!WARNING] 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.