clnt_call()

The clnt_call() call calls the remote procedure (procnum) associated with the client handle (clnt).

Syntax

#include <rpc\rpc.h>

enum clnt_stat
clnt_call(clnt, procnum, inproc, in, outproc, out, tout)
CLIENT *clnt;
u_long procnum;
xdrproc_t inproc;
char *in;
xdrproc_t outproc;
char *out;
struct timeval tout;

Parameters

clnt

Pointer to a client handle that was previously obtained using clntraw_create(), clnttcp_create(), or clntudp_create(). procnum

Remote procedure number. inproc

procnum

Pointer to the remote procedure's arguments. outproc

XDR procedure used to decode the remote procedure's results. out

Pointer to the remote procedure's results. tout

Time allowed for the server to respond, in units of 0.1 seconds.

Return Values

RPC_SUCCESS indicates success; otherwise, an error has occurred. The results of the remote procedure call are returned to out.

Examples

u_long procnum;register CLIENT *clnt;
enum clnt_stat cs;
struct timeval  total_timeout;
int intsend, intrecv;

cs=clnt_call(clnt, procnum, xdr_int, &intsend,
   xdr_int, &intrecv, total_timeout);
if ( cs != RPC_SUCCESS)
    printf("*Error* clnt_call fail :\n");

[Back: clnt_broadcast()]
[Next: clnt_destroy()]