rpc_inq_binding(3ncs)rpc_inq_binding(3ncs)Namerpc_inq_binding - return the socket address represented by an RPC han‐
dle (client or server)
Syntax
#include <idl/c/rpc.h>
void rpc_$inq_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 represented by handle.
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 enables a client to determine the socket address, and
therefore the server, identified by an RPC handle. It is useful when a
client uses an unbound handle in a remote procedure call and wishes to
determine the particular server that responded to the call.
Examples
The Location Broker administrative tool, uses the following statement
to determine the GLB that last responded to a lookup request:
rpc_$inq_binding(lb_$handle, &global_broker_addr,
&global_broker_addr_len, &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.
rpc_$unbound_handle The handle is not bound and does not represent a
particular host address. Returned by
FilesSee Alsointro(3ncs), rpc_bind(3ncs), rpc_set_binding(3ncs)rpc_inq_binding(3ncs)