NAME

rpc_object_set_inq_fn- registers an object inquiry function

SYNOPSIS

#include <dce/rpc.h>

void rpc_object_set_inq_fn(
	rpc_object_inq_fn_t inquiry_fn,
	unsigned32 *status);

PARAMETERS

Input

inquiry_fn

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.

Output

status

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:

rpc_s_ok

Success.

DESCRIPTION

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.

RETURN VALUE

None.

SEE ALSO

rpc_object_inq_type()
rpc_object_set_type().

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.