rpc_set_binding(3ncs)rpc_set_binding(3ncs)Namerpc_set_binding - bind an RPC handle to a server (client only)
Syntax
#include <idl/c/rpc.h>
void rpc_$set_binding(handle, sockaddr, slength, status)
handle_t handle;
socket_$addr_t *sockaddr;
unsigned long slength;
status_$t *status;
Arguments
handle An RPC handle.
sockaddr The socket address of the server with which the
handle is being associated.
slength The length, in bytes, of sockaddr.
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 sets the binding of an RPC handle to the specified server.
The handle then identifies a specific object at a specific server. Any
subsequent remote procedure calls that a client makes using the handle
are sent to this destination.
You can use this routine either to set the binding in an unbound handle
or to replace the existing binding in a fully bound or bound-to-host
handle.
Examples
The following statement sets the binding on the handle to the first
server in the array, which was returned by a previous Location Broker
lookup routine,
rpc_$set_binding (h, &lbresults[0].saddr, lbresults[0].saddr_len,
&status);
Diagnostics
This section lists status codes for errors returned by this routine in
rpc_$cant_bind_sock The RPC runtime library created a socket but was
unable to bind it to a socket address.
rpc_$not_in_call An internal error.
rpc_$proto_error An internal protocol error.
FilesSee Alsointro(3ncs), rpc_alloc_handle(3ncs), rpc_clear_binding(3ncs),
rpc_clear_server_binding(3ncs)rpc_set_binding(3ncs)
