rpc_inq_object(3ncs)rpc_inq_object(3ncs)Namerpc_inq_object - return the object UUID represented by an RPC handle
(client or server)
Syntax
#include <idl/c/rpc.h>
void rpc_$inq_object(handle, object, status)
handle_t handle;
uuid_$t *object;
status_$t *status;
Arguments
handle An RPC handle.
object The UUID of the object identified by handle.
status The completion status. If the completion status
returned in is equal to status_$ok , then the rou‐
tine that supplied it was successful.
Description
The routine enables a client or server to determine the particular
object that a handle represents.
If a server exports an interface through which clients can access sev‐
eral objects, it can use to determine the object requested in a call.
This routine requires an RPC handle as input, so the server can make
the call only if the interface uses explicit handles (that is, if each
operation in the interface has a handle parameter). If the interface
uses an implicit handle, the handle identifier is not passed to the
server.
Examples
A database server that manages multiple databases must determine the
particular database to be accessed whenever it receives a remote proce‐
dure call. Each manager routine makes the following call; the routine
then uses the returned UUID to identify the database to be accessed:
rpc_$inq_object (handle, &db_uuid, &status);
Diagnostics
This section lists status codes for errors returned by this routine in
rpc_$unk_if The requested interface is not known. It is not
registered in the server, the version number of the
registered interface is different from the version
number specified in the request, or the UUID in the
request does not match the UUID of the registered
interface.
rpc_$not_in_call An internal error.
rpc_$proto_error An internal protocol error.
FilesSee Alsointro(3ncs)rpc_inq_object(3ncs)