rpc_object_set_inq_fn- registers an object inquiry function
void rpc_object_set_inq_fn( rpc_object_inq_fn_t inquiry_fn, unsigned32 *status);
- Specifies a pointer to an object type inquiry function. When an application calls the rpc_object_inq_type() routine, and the RPC run-time system finds that the specified object is not registered, the run-time system automatically calls this routine to determine the object's type. Specifying NULL removes a previously set inquiry function.
- Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.
Possible status codes and their meanings include:
A server application calls the rpc_object_set_inq_fn() routine to specify a function to determine an object's type. If an application privately maintains object/type registrations, the specified inquiry function returns the type UUID of an object from that registration.
The RPC run-time system automatically calls the inquiry function when the application calls routine rpc_object_inq_type() and the object was not previously registered by the rpc_object_set_type() routine. The RPC run-time system also automatically calls the inquiry function for every remote procedure call it receives if the object was not previously registered by rpc_object_set_type().
The following C-language definition for rpc_object_inq_fn_t illustrates the prototype for this function:
- typedef void (*rpc_object_inq_fn_t) ( uuid_t *object_uuid, /* in */ uuid_t *type_uuid, /* out */ unsigned32 *status /* out */
The returned type_uuid and status values are returned as the output arguments from the rpc_object_inq_type() routine.
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.