rpc_dup_handle(3ncs) rpc_dup_handle(3ncs)
Name
rpc_dup_handle - make a copy of an RPC handle (client only)
Syntax
#include <idl/c/rpc.h>
handle_t rpc_$dup_handle(handle, status)
handle_t handle;
status_$t *status;
Arguments
handle The RPC handle to be copied.
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 returns a copy of an existing RPC handle. Both handles can then be used in the client program for concurrent multiple accesses
to a binding. Because all duplicates of a handle reference the same data, an or routine made on any one duplicate affects all duplicates.
However, an RPC handle is not freed until is called on all copies of the handle.
Files
See Also
intro(3ncs), rpc_alloc_handle(3ncs), rpc_free_handle(3ncs)
rpc_dup_handle(3ncs)