NAME

rpc_string_binding_compose- combines the components of a string binding into a string binding

SYNOPSIS

#include <dce/rpc.h>

void rpc_string_binding_compose(
	unsigned_char_t *obj_uuid,
	unsigned_char_t *protseq,
	unsigned_char_t *network_addr,
	unsigned_char_t *endpoint,
	unsigned_char_t *options,
	unsigned_char_t **string_binding,
	unsigned32 *status);

PARAMETERS

Input

obj_uuid

Specifies a string representation of an object UUID.

protseq

Specifies a representation of a protocol sequence.

network_addr

Specifies a string representation of a network address.

endpoint

Specifies a string representation of an endpoint.

options

Specifies a string representation of network options.

Input/Output

string_binding

Returns a pointer to a string representation of a binding.

Specifying NULL prevents the routine from returning this argument. In this case, no string is allocated.

Output

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_string_binding_compose() routine combines string binding handle components into a string binding. (See RPC Data Types for information on the syntax of string bindings.)

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

A NULL or empty string ("") argument specifies that an input string that has no data.

RETURN VALUE

None.

SEE ALSO

rpc_binding_from_string_binding()
rpc_binding_to_string_binding()
rpc_string_binding_parse()
rpc_string_free()
uuid_to_string().

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.