rpc_free_handle(3ncs)rpc_free_handle(3ncs)Namerpc_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 suc‐
cessful.
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.
FilesSee Alsointro(3ncs), rpc_alloc_handle(3ncs), rpc_dup_handle(3ncs)rpc_free_handle(3ncs)