VMS Help  —  DCE  DCE_RPC, Application Routines, rpc_string_binding_compose
 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_uuid
       Specifies a NULL-terminated string representation of an object
       UUID.

   protseq
       Specifies a NULL-terminated string representation of a protocol
       sequence.

   network_addr
       Specifies a NULL-terminated string representation of a network
       address.

   endpoint
       Specifies a NULL-terminated string representation of an endpoint.

   options
       Specifies a NULL-terminated string representation of network
       options.

   Output

   string_binding
       Returns 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 rpc_string_free().

   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 code and its meaning is as follows:

       rpc_s_ok            Success.

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

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

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_binding_from_string_binding
              rpc_binding_to_string_binding
              rpc_string_binding_parse
              rpc_string_free
              uuid_to_string
Close Help