svc_freeargs()--Free Data Allocated by the RPC or XDR System

Syntax

 #include <rpc/rpc.h>

 bool_t svc_freeargs(const SVCXPRT *xprt,
                              const xdrproc_t inproc,
                              caddr_t in);

  Service Program Name: QZNFTRPC

  Default Public Authority: *USE

  Threadsafe: No

The svc_freeargs() function frees any data allocated by the RPC or XDR functions when those functions decode the arguments to a service procedure by using svc_getargs().

Parameters

xprt (Input): A pointer to the RPC service transport handle.
inproc (Input): The XDR routine to free the arguments.
in (Input): The address of the arguments.

Authorities

No authorization is required.

Return Value

TRUE (1)	svc_freeargs was successful.
FALSE (0)	svc_freeargs was unsuccessful.

Error Conditions

svc_freeargs() returns FALSE only when the in parameter is NULL or an exception has occurred. In case of the exception, the errno global variable is set to EUNKNOWN.

Error Messages

Message ID	Error Message Text
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF9872 E	Program or service program &1 in library amp;2 ended. Reason code &3.

Example

Refer to the example for svcerr_systemerr()--Send Information to Client for System Error.

API introduced: V4R2

[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]