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

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

   Output

   string_binding
       Returns a pointer to the string representation of the binding
       handle specified in the binding parameter.

   status
       Returns 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_ok    Success.

       rpc_s_cant_getpeername
                   Cannot get peer name.

       rpc_s_connection_closed
                   Connection closed.

       rpc_s_invalid_binding
                   Invalid 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 parameter. The application calls the rpc_string_free()
   routine to deallocate that memory.

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

   To parse the returned string_binding parameter, call
   rpc_string_binding_parse().

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_binding_from_string_binding
              rpc_string_binding_parse
              rpc_string_free