array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.com-get-active-object.php', 1 => 'com_get_active_object', 2 => 'Retorna um identificador para uma instância já em execução de um objeto COM', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'Funções de COM', ), 'prev' => array ( 0 => 'function.com-event-sink.php', 1 => 'com_event_sink', ), 'next' => array ( 0 => 'function.com-load-typelib.php', 1 => 'com_load_typelib', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/com/functions/com-get-active-object.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

com_get_active_object

(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

Descrição

com_get_active_object(string $prog_id, ?int $codepage = null): variant

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.

Parâmetros

prog_id

prog_id deve ser o ProgID ou CLSID do objeto que a ser acessado (por exemplo Word.Application).

codepage

Atua exatamente da mesma maneira que para a classe com.

Valor Retornado

Se o objeto solicitado estiver em execução, ele será retornado ao script como qualquer outro objeto COM.

Erros/Exceções

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.

Registro de Alterações

Versão Descrição
8.0.0 codepage agora pode ser nulo.

Notas

Aviso

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.