rpc_clear_binding(3ncs)rpc_clear_binding(3ncs)Namerpc_clear_binding - unset the binding of an RPC handle to a host and
server (client only)
Syntax
#include <idl/c/rpc.h>
void rpc_$clear_binding(handle, status)
handle_t handle;
status_$t *status;
Arguments
handle The RPC handle whose binding is being cleared.
status The completion status. If the completion status returned in is
equal to status_$ok , then the routine that supplied it was suc‐
cessful.
Description
The routine removes any association between an RPC handle and a partic‐
ular server and host, but it does not remove the association between
the handle and an object. This routine saves the RPC handle so that it
can be reused to access the same object, either by broadcasting or
after resetting the binding to another server.
A remote procedure call made using an unbound handle is broadcast to
all Local Location Brokers (LLBs) on the local network. If the call's
interface and the object identified by the handle are both registered
with any LLB, that LLB forwards the request to the registering server.
The client RPC runtime library returns the first response that it
receives and binds the handle to the first server that responded.
The routine is the inverse of the routine.
Examples
Clear the binding represented in handle:
rpc_$clear_binding (handle, &status);
Diagnostics
This section lists status codes for errors returned by this routine in
rpc_$not_in_call An internal error.
rpc_$proto_error An internal protocol error.
FilesSee Alsointro(3ncs), rpc_bind(3ncs), rpc_clear_server_binding(3ncs),
rpc_set_binding(3ncs)rpc_clear_binding(3ncs)