Previous section.

CDE 1.1: Remote Procedure Call
Copyright © 1997 The Open Group

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.

Contents Next section Index