beautypg.com

6 client-initialization function – Renesas Stub Generator V.1.00 User Manual

Page 112

background image

Section 8 Application Interface

Rev. 1.01 Mar. 17, 2008 Page 100 of 128

REJ10J1822-0101

8.6

Client-Initialization Function

The client-initialization function is called by the client application and initiates connection to the
server by using rpc_connect().

When CLNT_NOINIT has not been specified, RPCGEN generates a client-initialization function
rpcclnt__init. RPCGEN outputs the client-initialization function itself to file>_clnt.c and the prototype declaration to _clnt.h.

refers to the server name defined with SVR_NAME.

When CLNT_NOINIT has been specified, RPCGEN does not generate a client-initialization
function. The client-initialization function must be provided by the user if one is required.

The specification of the client-initialization function generated by RPCGEN is as follows.

• C-language API

INT32 rpcclnt__init(UINT32 __ulRPCServerID, UINT32

__ulRPCServerVersion);

• Return value

The return value of rpc_connect()

• Parameter: __ulRPCServerID and __ulRPCServerVersion

These parameters indicate the server ID and server version, respectively. When SVR_AUTH
has not been specified, however, the server ID and server version are ignored. Instead, the
macros RPCSVR_ID_ and RPCSVR_VERS_ output to file>_public.h are taken as the server ID and version in initiating connection to the server.

• Specification

Connection to the server is initiated by using rpc_connect().

This manual is related to the following products: