NAME

rpc_binding_to_string_binding- returns a string representation of a binding handle

SYNOPSIS

#include <dce/rpc.h>

void rpc_binding_to_string_binding(
	rpc_binding_handle_t binding,
	unsigned_char_t **string_binding,
	unsigned32 *status);

PARAMETERS

Input

binding

Specifies a client or server binding handle to convert to a string representation of a binding handle.

Output

string_binding

Returns a pointer to the string representation of the binding handle specified in the binding argument.

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_to_string_binding() routine converts a client or server binding handle to its string representation.

The RPC run-time system allocates memory for the string returned in the string_binding argument. The application calls the rpc_string_free() routine to deallocate that memory.

When the binding handle in the binding argument contains a nil object UUID, the object UUID field is not included in the returned string.

RETURN VALUE

None.

SEE ALSO

rpc_binding_from_string_binding()
rpc_string_binding_parse()
rpc_string_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.