rpc_set_binding(3ncs)

Name

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

Description

The rpc_$set_binding 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 h to the first server in the lbresults array, which was returned by a previous Location Broker lookup routine, lb_lookup_interface:

rpc_$set_binding (h, &lbresults[0].saddr, lbresults[0].saddr_len,
&status);

Diagnostics

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

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.

Files

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

Museum

Related Articles