rpc_unregister(3ncs) rpc_unregister(3ncs)
Name
rpc_unregister - unregister an interface (server only)
Syntax
#include <idl/c/rpc.h>
void rpc_$unregister(ifspec, status)
rpc_$if_spec_t *ifspec;
status_$t *status;
Arguments
ifspec An rpc_$if_spec_t. An interface specifier obtained from a previous RPC register call. The interface being unregis-
tered.
status The completion status. If the completion status returned in is equal to status_$ok , then the routine that supplied it
was successful.
Description
The routine unregisters an interface that the server previously registered with the RPC runtime library. After an interface is unregis-
tered, the RPC runtime library will not pass requests for that interface to the server.
If a server uses several or routines to register an interface more than once, then it must call an equal number of times to unregister the
interface.
Examples
The following statement unregisters a matrix arithmetic interface:
rpc_$unregister (&matrix_$if_spec, &status);
Diagnostics
This section lists status codes for errors returned by this routine in
rpc_$op_rng_error The requested operation does not correspond to a valid operation in the requested interface.
rpc_$unk_if The requested interface is not known. It is not registered in the server, the version number of the registered inter-
face 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.
Files
See Also
intro(3ncs), rpc_register(3ncs), rpc_register_mgr(3ncs), rpc_register_object(3ncs)
rpc_unregister(3ncs)
