Filter
Top Products
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().