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)
