NAME

rpc_binding_copy-returns a copy of a binding handle

SYNOPSIS

#include <dce/rpc.h>

void rpc_binding_copy(
	rpc_binding_handle_t source_binding,
	rpc_binding_handle_t *destination_binding,
	unsigned32 *status);

PARAMETERS

Input

source_binding

Specifies the server binding handle whose referenced binding information will be copied.

Output

destination_binding

Returns the server binding handle that refers to the copied binding information.

status

Returns the status code from this routine. The status code indicates whether the routine completed successfully or, if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

DESCRIPTION

The rpc_binding_copy() routine copies the server binding information referenced by the binding handle specified in the source_binding argument. This routine returns a new server binding handle for the copied binding information. The new server binding handle is returned in the destination_binding argument.

After calling this routine, operations performed on the source_binding binding handle do not affect the binding information referenced by the destination_binding binding handle. Similarly, operations performed on the destination_binding binding handle do not affect the binding information referenced by the source_binding binding handle.

Note:

To release the memory used by the destination_binding binding handle and its referenced binding information, the application calls the rpc_binding_free() routine.

RETURN VALUE

None.

SEE ALSO

rpc_binding_free().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.