FactoryFinder Interface

e-docs > Tuxedo > Administering a Tuxedo Application at Run Time > FactoryFinder Interface

Administering a Tuxedo Application at Run Time

DI.find_factories_by_id

Synopsis

Obtains a list of application factories.

MIDL Mapping

HRESULT find_factories_by_id(
  [in] BSTR factory_id,
  [in,out,optional] VARIANT* exceptionInfo, 
  [out,retval] VARIANT* returnValue);

Automation Mapping

Function find_factories_by_id(factory_id As String,
                                  [exceptionInfo])

Parameters

factory_id

This parameter represents a string identifier that will be used to identify the kind or type of application factory. The Creating CORBA Client Applications online document provides some suggestions as to the composition of this string.

exceptionInfo

An optional input argument that enables the application to get additional exception data if an error occurred.

Exceptions

NoFactory

This exception is raised if the FactoryFinder cannot find an application factory object reference that corresponds to the input factory_key or factory_id.

Description

This member function instructs the FactoryFinder to return a list of application factory object references whose id in the keys match the method's input factory_id. performs an equality match (that is, the input factory_id must exactly match each id in the <id,kind> pair in the application factory's keys).

Return Values

Returns a variant containing an array of interface pointers to application factories.