ultrix man page for rpc_free_handle

rpc_free_handle(3ncs)													     rpc_free_handle(3ncs)

Name
       rpc_free_handle - free an RPC handle (client only)

Syntax
       #include <idl/c/rpc.h>

       void rpc_$free_handle(handle, status)
       handle_t handle;
       status_$t *status;

Arguments
       handle The RPC handle to be freed.

       status The completion status.  If the completion status returned in is equal to status_$ok , then the routine that supplied it was success-
	      ful.

Description
       The routine frees an RPC handle.  This routine clears any association between the handle and  a	server	or  an	object	and  releases  the
       resources identified by the RPC handle.	The client program cannot use a handle after it is freed.

Examples
       The following statement frees a handle:
       rpc_$free_handle (handle, &status);

Diagnostics
       This section lists status codes for errors returned by this routine in

       rpc_$not_in_call    An internal error.

       rpc_$proto_error    An internal protocol error.

Files
See Also
       intro(3ncs), rpc_alloc_handle(3ncs), rpc_dup_handle(3ncs)

															     rpc_free_handle(3ncs)