NAME

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

Used by client or server applications. 

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_uuidSpecifies a null-terminated string representation of an object UUID. 

protseqSpecifies a null-terminated string representation of a protocol sequence. 

network_addrSpecifies a null-terminated string representation of a network address. 

endpointSpecifies a null-terminated string representation of an endpoint. 

optionsSpecifies a null-terminated string representation of network options. 

Output

string_bindingReturns a pointer to a null-terminated string representation of a binding handle.  Specify NULL to prevent the routine from returning this argument. In this case the application does not call the rpc_string_free routine. 

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not.  not, why.  The possible status code and its meaning is as follows:

rpc_s_okSuccess. 

DESCRIPTION

The rpc_string_binding_compose routine combines string binding handle components into a string binding handle. 

The RPC runtime allocates memory for the string returned in the string_binding argument. The application calls the rpc_string_free routine to deallocate that memory. 

Specify NULL or provide a null string (\0) for each input string that has no data. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_binding_from_string_binding(3), rpc_binding_to_string_binding(3), rpc_string_binding_parse(3), rpc_string_free(3), uuid_to_string(3)