Name

rpc_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 status.all is equal to status_$ok , then the routine that supplied it was successful. 

Description

The rpc_$clear_binding routine removes any association between an RPC handle and a particular 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 rpc_$clear_binding routine is the inverse of the rpc_$set_binding routine.

Examples

Clear the binding represented in handle:

rpc_$clear_binding (handle, &status);

Diagnostics

This section lists status codes for errors returned by this rpc_$ routine in status.all.

rpc_$not_in_call An internal error. 

rpc_$proto_error An internal protocol error. 

Files

/usr/include/idl/c/rpc.h
/usr/include/idl/rpc.idl

See Also

intro(3ncs), rpc_bind(3ncs), rpc_clear_server_binding(3ncs), rpc_set_binding(3ncs)