rpc_object_inq_type(3rpc)
Returns the type of an object
Used by server applications.
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. Supply NULL to specify a nil UUID for this parameter.
Output
type_uuid
Returns the type UUID corresponding to the object UUID supplied in the obj_uuid parameter.
Specifying NULL here prevents the return of a type UUID. An application, by specifying NULL here, can determine from the value returned in status whether obj_uuid is registered. This determination occurs without the application specifying an output type UUID variable.
status
Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not.
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 runtime using the rpc_object_set_type( ) routine, the registered type is returned.
Optionally, an application can maintain an object/type registration privately. In this case, if the application provides an object inquiry function (see rpc_object_set_inq_fn(3rpc) ), the RPC runtime uses that function to determine an object's type.
The following table shows how rpc_object_inq_type( ) obtains the returned type UUID.
| Rules for Returning an Object's Type |
| Was object UUID registered (using rpc_object_set_type)? | Was an object inquiry function registered (using rpc_object_set_inq_fn)? | 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. |
No value is returned.
Errors
The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
rpc_s_ok
Success.
rpc_s_object_not_found
Object not found.
uuid_s_bad_version
Bad UUID version.
Related Information
Functions: rpc_object_set_inq_fn(3rpc)