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 status.all is equal to status_$ok , then the routine that supplied it was successful.
Description
The rpc_$free_handle 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 rpc_$ routine in status.all.
rpc_$not_in_call An internal error.
rpc_$proto_error An internal protocol error.
Files
/usr/include/idl/c/rpc.h
/usr/include/idl/rpc.idl