PHP
Referenzliste
com_get_active_object
COM Funktionen
Befehl:
variant com_get_active_object ( string $progid [, int $code_page ] )
Parameter-Liste:
Beschreibung | |
---|---|
progid muss entweder die ProgID oder CLSID für das Objekt sein, auf die Sie zugreifen möchten (zum Beispiel Word.Application). | |
Apostelgeschichte in genau der gleichen Weise, dass es für die COM-Klasse tut. |
Rückgabewerte:
Wenn die angeforderte Objekt ausgeführt wird, wird es zu Ihrem Skript wie jedes andere COM-Objekt zurückgegeben werden.
Beschreibung:
com_get_active_object() ist ähnlich wie das Erstellen einer neuen Instanz eines COM-Objekts, mit der Ausnahme, dass es nur ein Objekt, um Ihr Skript zurück, wenn das Objekt bereits ausgeführt wird. OLE-Anwendungen verwenden, etwas als "Running Object Table" bekannt, damit bekannte Anwendungen nur einmal gestartet werden, diese Funktion macht die COM-Bibliothek-Funktion GetActiveObject() in den Griff zu einer laufenden Instanz zu bekommen.
Aktiv in Version:
(PHP 5, PHP 7)
Fehler:
Hinweis:
Es gibt eine Vielzahl von Gründen, warum diese Funktion fehlschlagen, die häufigste ist, dass das Objekt nicht bereits ausgeführt wird. In dieser Situation wird die Ausnahme Fehlercode
MK_E_UNAVAILABLE
, man kann das getCode-Methode des Ausnahme-Objekt verwenden, um die Ausnahme-Code zu überprüfen.Warnung:
Warnung:
Mit com_get_active_object() in einem Web-Server-Kontext ist nicht immer eine gute Idee. Die meisten COM / OLE-Anwendungen sind nicht für mehr als einen Client gleichzeitig verarbeiten, auch (oder gerade!) Microsoft Office. Sie sollten »Überlegungen für serverseitige Automatisierung von Office für weitere Informationen über das Lesen allgemeine Fragen.
com_get_active_object() - Beispiel:
Eingabe:
Im moment noch keine Beispiele vorhanden
COM Funktionen