NAME

rpc_binding_to_string_binding - Returns a string representation of a binding handle

Used by client, server, or management applications. 

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

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

Output

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

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not.  The possible status codes and their meanings are as follows:

rpc_s_okSuccess. 

rpc_s_invalid_bindingInvalid binding handle. 

DESCRIPTION

The rpc_binding_to_string_binding routine converts a client or server binding handle to its string representation. 

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. 

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

To parse the returned string_binding argument, call the rpc_string_binding_parse routine. 

RETURN VALUES

None. 

RELATED INFORMATION

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