Renesas V.1.00 Manuale Utente

Pagina di 142
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_<server name>_init. RPCGEN outputs the client-initialization function itself to <config 
file>_clnt.c and the prototype declaration to <config file>_clnt.h. 
<Server name> 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_<server name>_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_<server name> and RPCSVR_VERS_<server name> output to <config 
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().