rpc_unregister(3ncs)rpc_unregister(3ncs)Namerpc_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 unregistered.
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 unregisters an interface that the server previously regis‐
tered with the RPC runtime library. After an interface is unregis‐
tered, the RPC runtime library will not pass requests for that inter‐
face 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 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_register(3ncs), rpc_register_mgr(3ncs), rpc_regis‐
ter_object(3ncs)rpc_unregister(3ncs)