PreviousNext

Using cxx_lookup to Declare a Server's Object Lookup Function

If a client requests the use of a known object that is not yet in the server's runtime, the server can automatically look it up and create it by using an application-specify function. The object lookup function name is specified by using the cxx_lookup attribute in an ACF header. The ACF format is as follows:

cxx_lookup (object_lookup_function)

The object_lookup_function must be declared in a header file and included in the server stub by using the sstub attribute with the include statement in the ACF. The C++ function declaration must have the following format:

interface_name *object_lookup_function( uuid_t * );

The lookup function has one input pointer argument of type uuid_t representing the UUID of the object desired. The function returns a pointer to the interface class. The returned pointer represents the newly created object. If the object cannot be found or created, the function must return a zero.