NAME

rpc_object_inq_type- returns the type of an object

SYNOPSIS

#include <dce/rpc.h>

void rpc_object_inq_type(
	uuid_t *obj_uuid,
	uuid_t *type_uuid,
	unsigned32 *status);

PARAMETERS

Input

obj_uuid

Specifies the object UUID whose associated type UUID is returned. This may be the nil UUID.

Output

type_uuid

Returns the type UUID corresponding to the object UUID supplied in argument obj_uuid.

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.

rpc_s_object_not_found

Object not found.

DESCRIPTION

A server application calls the rpc_object_inq_type() routine to obtain the type UUID of an object.

If the object is registered with the RPC run-time system using the rpc_object_set_type() routine, the registered type is returned.

An application can also privately maintain an object/type registration. In this case, if the application provides an object inquiry function (see tagmref_rpc_object_set_inq_fn ). the RPC run-time system uses that function to determine an object's type.

The following table summarises how routine rpc_object_inq_type() obtains the returned type UUID.

Has the application registered an:
_	_
Object UUID?	Object inquiry function?	Return Value
Yes	(Ignored)	Returns the object's registered type UUID.
No	Yes	Returns the type UUID returned from calling the inquiry function.
No	No	Returns the nil UUID.

Table: Rules for Returning an Object's Type

RETURN VALUE

None.

SEE ALSO

rpc_object_set_inq_fn()
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.