VMS Help DCE_RPC, Application Routines, rpc_string_binding_parse  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   rpc_string_binding_parse - Returns, as separate strings, the
                              components of a string binding

   Used by client or server applications.

 SYNOPSIS

   #include <dce/rpc.h>

   void rpc_string_binding_parse( unsigned_char_t *string_binding,
                                  unsigned_char_t **obj_uuid,
                                  unsigned_char_t **protseq,
                                  unsigned_char_t **network_addr,
                                  unsigned_char_t **endpoint,
                                  unsigned_char_t **network_options,
                                  unsigned32 *status );

 PARAMETERS

   Input

   string_binding
       Specifies a NULL-terminated string representation of a binding.

   Output

   obj_uuid
       Returns a pointer to a NULL-terminated string representation
       of an object UUID.  Specify NULL to prevent the routine from
       returning this parameter.  In this case the application does
       not call rpc_string_free().

   protseq
       Returns a pointer to a NULL-terminated string representation
       of a protocol sequence.  Specify NULL to prevent the routine
       from returning this parameter.  In this case the application
       does not call rpc_string_free().

   network_addr
       Returns a pointer to a NULL-terminated string representation
       of a network address.  Specify NULL to prevent the routine
       from returning this parameter.  In this case the application
       does not call rpc_string_free().

   endpoint
       Returns a pointer to a NULL-terminated string representation of
       an endpoint.  Specify NULL to prevent the routine from returning
       this parameter. In this case the application does not call
       rpc_string_free().

   network_options
       Returns a pointer to a NULL-terminated string representation of
       network options.  Specify NULL to prevent the routine from
       returning this parameter.  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 codes and their meanings are as
       follows:

       rpc_s_ok                        Success.

       rpc_s_invalid_string_binding    Invalid string binding.

 DESCRIPTION

   The rpc_string_binding_parse() routine parses a string representation
   of a binding handle into its component fields.

   The RPC runtime allocates memory for each component string the
   routine returns.  The application calls rpc_string_free() once for
   each returned string to deallocate the memory for that string.

   If any field of the string_binding field is empty,
   rpc_string_binding_parse() returns the empty string in the
   corresponding output parameter.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_binding_from_string_binding
              rpc_binding_to_string_binding
              rpc_string_binding_compose
              rpc_string_free
              uuid_from_string