rpc_bind(3ncs)rpc_bind(3ncs)Namerpc_bind - allocate an RPC handle and set its binding to a server
(client only)
Syntax
#include <idl/c/rpc.h>
handle_t rpc_$bind(object, sockaddr, slength, status)
uuid_$t *object;
socket_$addr_t *sockaddr;
unsigned long slength;
status_$t *status;
Arguments
object The UUID of the object to be accessed. If there is
no specific object, specify uuid_$nil.
sockaddr The socket address of the server.
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 creates a fully bound RPC handle that identifies a particu‐
lar object and server. This routine is equivalent to an routine fol‐
lowed by an routine.
Examples
The following statement binds the binop client to the specified object
and socket address. The loc parameter is the result of a previous call
to which converted the host name and port number to a socket address.
rh = rpc_$bind (&uuid_$nil, &loc, llen, &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_clear_binding(3ncs), rpc_clear_server_binding(3ncs),
rpc_set_binding(3ncs)rpc_bind(3ncs)