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 status.all is equal to status_$ok , then the routine that supplied it was successful.
Description
The rpc_$dup_handle 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 rpc_$set_binding, rpc_$clear_binding, or rpc_$clear_server_binding routine made on any one duplicate affects all duplicates. However, an RPC handle is not freed until rpc_$free_handle is called on all copies of the handle.
Files
/usr/include/idl/c/rpc.h
/usr/include/idl/rpc.idl