FactoryFinder Interface

CORBA Programming Reference

DI.find_factories

Synopsis

Obtains a list of application factories.

MIDL Mapping

HRESULT find_factories(
  [in] VARIANT factory_key, 
  [in,out,optional] VARIANT* exceptionInfo, 
  [out,retval] VARIANT* returnValue);

Automation Mapping

Function find_factories(factory_key, [exceptionInfo])

Parameters

factory_key

This parameter contains a safe array of DICosNaming_NameComponents (<id, kind> value pairs) that uniquely identifies a factory object reference.

exceptionInfo

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

Exception

NoFactory

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

Description

The find_factories method instructs the FactoryFinder to return a list of server application factory object references whose keys match the method's input key. The BEA Tuxedo system assumes that an equality match is to be performed. This means that for the two sequences of <id,kind> pairs (those corresponding to the input key and those in the application factory's keys), each are of equal length; for every pair in one sequence, there is an identical pair in the other.

Return Values

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