array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'tr', ), 'this' => array ( 0 => 'function.com-get-active-object.php', 1 => 'com_get_active_object', 2 => 'COM nesnesinin çalışan bir örneği için tanıtıcı döner', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'COM İşlevleri', ), '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' => 'tr', '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 — COM nesnesinin çalışan bir örneği için tanıtıcı döner

Açıklama

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

com_get_active_object() işlevi com nesnesinden yeni bir örnek yaratma ile benzer işi yapar. Aralarındaki fark eğer nesne hali hazırda çalışıyorsa işlevden bir nesne dönecektir. OLE uygulamaları, sık kullanılan uygulamaları sadece bir kez yüklemek için Çalışan Nesne Tablosu ("Running Object Table") olarak bilinen yapıyı kullanır; bu işlev çalışan nesne tanıtıcısını almak için COM kütüphanesinden GetActiveObject() işlevini kullanır.

Bağımsız Değişkenler

prog_id

Erişmek istediğiniz nesne için (örneğin Word.Application) prog_id bağımsız değişkeni ProgID veya CLSID olmalıdır.

kod_sayfası

Tam olarak com sınıfındaki gibi rol oynar.

Dönen Değerler

İstenen nesne çalışıyorsa, betiğinizdeki herhangi bir COM nesnesi gibi döndürülecektir.

Sürüm Bilgisi

Sürüm: Açıklama
8.0.0 kod_sayfası artık null olabiliyor.

Hatalar/İstisnalar

İşlevin başarısız olmasının çeşitli nedenleri vardır, en sık karşılaşılan istenen nesnenin çalışmamasından kaynaklanır. Bu durumda, istisna hata kodu MK_E_UNAVAILABLE olacaktır; Hata kodunu kontrol etmek için istisna nesnesinin getCode yöntemini kullanabilirsiniz.

Notlar

Uyarı

com_get_active_object() işlevini bir html sunucuda kullanmak akıllıca bir fikir değildir. Birçok COM/OLE uygulaması eşzamanlı birden fazla istemci ile çalışacak şekilde tasarlanmamıştır, hatta (özellikle) Microsoft Office bile. Bu konuda daha fazla bilgi için » Sunucu taraflı ofis özdevinimi üzerine düşünceler adresine bakınız.