rpc_object_inq_type- returns the type of an object
void rpc_object_inq_type( uuid_t *obj_uuid, uuid_t *type_uuid, unsigned32 *status);
- Specifies the object UUID whose associated type UUID is returned. This may be the nil UUID.
- Returns the type UUID corresponding to the object UUID supplied in argument obj_uuid.
- 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:
Object not found.
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
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.