NAME

rpc_string_binding_parse- returns, as separate strings, the object UUID and address components of a string binding

SYNOPSIS

#include <dce/rpc.h>

void rpc_string_binding_parse(
	unsigned_char_t *string_binding,
	unsigned_char_t **obj_uuid,
	unsigned_char_t **protseq,
	unsigned_char_t **network_addr,
	unsigned_char_t **endpoint,
	unsigned_char_t **network_options,
	unsigned32 *status);

PARAMETERS

Input

string_binding

Specifies a string representation of a binding.

Input/Output

obj_uuid

Returns a string representation of an object UUID.

Specifying NULL prevents the routine from returning this argument.

protseq

Returns a string representation of a protocol sequence.

Specifying NULL prevents the routine from returning this argument.

network_addr

Returns a string representation of a network address.

Specifying NULL prevents the routine from returning this argument.

endpoint

Returns a string representation of an endpoint.

Specifying NULL prevents the routine from returning this argument.

network_options

Returns a string representation of network options.

Specifying NULL prevents the routine from returning this argument.

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_parse() routine parses a string representation of a binding into its component fields.

The RPC run-time system allocates memory for each component string the routine returns. To deallocate this memory, the application calls the rpc_string_free() routine once for each returned string. When NULL is specified for a component, no memory is allocated and no string is returned so the application need not call rpc_string_free().

When a field of the string_binding is empty, the rpc_string_binding_parse() routine returns the empty string ("") in the corresponding output.

RETURN VALUE

None.

SEE ALSO

rpc_binding_from_string_binding()
rpc_binding_to_string_binding()
rpc_string_binding_compose()
rpc_string_free()
uuid_from_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.