com_get_active_object(3) [php man page]

COM_GET_ACTIVE_OBJECT(3)						 1						  COM_GET_ACTIVE_OBJECT(3)

com_get_active_object - Returns a handle to an already running instance of a COM object

SYNOPSIS

       variant com_get_active_object (string  $progid, [int  $code_page])

DESCRIPTION

       com_get_active_object(3)  is similar to creating a new instance of a "COM" object, except that it will only return an object to your script
       if the object is already running. OLE applications use something known as the " Running Object Table" to allow well-known  applications	to
       be launched only once; this function exposes the COM library function GetActiveObject() to get a handle on a running instance.

PARAMETERS

	      o $progid
		-$progid must be either the ProgID or CLSID for the object that you want to access (for example Word.Application).

	      o $code_page
		- Acts in precisely the same way that it does for the "COM" class.

RETURN VALUES

	If the requested object is running, it will be returned to your script just like any other COM object.

ERRORS
/EXCEPTIONS
	There  are a variety of reasons why this function might fail, the most common being that the object is not already running. In that situa-
       tion, the exception error code will be MK_E_UNAVAILABLE; you can use the getCode method of the exception  object  to  check  the  exception
       code.

NOTES

       Warning

	       Using  com_get_active_object(3)	in  a web server context is not always a smart idea. Most COM/OLE applications are not designed to
	      handle more than one client concurrently, even (or especially!) Microsoft Office. You should read Considerations for Server-Side Au-
	      tomation of Office for more information on the general issues involved.

PHP Documentation Group 												  COM_GET_ACTIVE_OBJECT(3)

TAP::Object(3pm)					 Perl Programmers Reference Guide					  TAP::Object(3pm)

NAME

       TAP::Object - Base class that provides common functionality to all "TAP::*" modules

VERSION

       Version 3.26

SYNOPSIS

	   package TAP::Whatever;

	   use strict;
	   use vars qw(@ISA);

	   use TAP::Object;

	   @ISA = qw(TAP::Object);

	   # new() implementation by TAP::Object
	   sub _initialize {
	       my ( $self, @args) = @_;
	       # initialize your object
	       return $self;
	   }

	   # ... later ...
	   my $obj = TAP::Whatever->new(@args);

DESCRIPTION

       "TAP::Object" provides a default constructor and exception model for all "TAP::*" classes.  Exceptions are raised using Carp.

METHODS

   Class Methods
       "new"

       Create a new object.  Any arguments passed to "new" will be passed on to the "_initialize" method.  Returns a new object.

   Instance Methods
       "_initialize"

       Initializes a new object.  This method is a stub by default, you should override it as appropriate.

       Note: "new" expects you to return $self or raise an exception.  See "_croak", and Carp.

       "_croak"

       Raise an exception using "croak" from Carp, eg:

	   $self->_croak( 'why me?', 'aaarrgh!' );

       May also be called as a class method.

	   $class->_croak( 'this works too' );

       "_confess"

       Raise an exception using "confess" from Carp, eg:

	   $self->_confess( 'why me?', 'aaarrgh!' );

       May also be called as a class method.

	   $class->_confess( 'this works too' );

       "_construct"

       Create a new instance of the specified class.

       "mk_methods"

       Create simple getter/setters.

	__PACKAGE__->mk_methods(@method_names);

perl v5.18.2							    2014-01-06							  TAP::Object(3pm)