(PHP 5, PHP 7, PHP 8)
com_get_active_object — Retorna um identificador para uma instância já em execução de um objeto COM
com_get_active_object() é semelhante a criar uma nova
instância de um objeto com, exceto que só
retornará um objeto ao script se o objeto já estiver em execução.
Os aplicativos OLE usam algo conhecido como "Running Object Table"
para permitir que aplicativos bem conhecidos sejam iniciados apenas uma vez; esta função
expõe a função GetActiveObject() da biblioteca COM para obter um identificador em uma
instância em execução.
prog_id
prog_id deve ser o ProgID ou CLSID do
objeto que a ser acessado (por exemplo
Word.Application).
codepageAtua exatamente da mesma maneira que para a classe com.
Se o objeto solicitado estiver em execução, ele será retornado ao script como qualquer outro objeto COM.
Há vários motivos pelos quais essa função pode falhar, sendo o mais
comum o fato de o objeto ainda não estar em execução. Nessa situação,
o código de erro de exceção será MK_E_UNAVAILABLE;
o método getCode do objeto de exceção pode ser usado
para verificar o código da exceção.
| Versão | Descrição |
|---|---|
| 8.0.0 |
codepage agora pode ser nulo.
|
Usar com_get_active_object() em um contexto de servidor web nem sempre é uma ideia inteligente. A maioria das aplicações COM/OLE não é projetada para lidar com mais de um cliente simultaneamente, mesmo (ou especialmente!) o Microsoft Office. Consulte as » Considerações para Automação do Office no Lado do Servidor para obter mais informações sobre os problemas gerais envolvidos.
Please note the next behavior (Apache 2.2.8, W2K, WXP)
If Apache runs as a service, com_get_active_object() always returns MK_E_UNAVAILABLE, even when it is definitely sure that the Running Object Table contains a reference to the required object.
If Apache runs in a console, com_get_active_object() returns the object handle as required.
This apparently is a Windows issue.