NAME

   uuid_to_string - Converts a UUID from a binary representation to
                    a string representation

   Used by client, server, or management applications.

 SYNOPSIS

   #include <dce/uuid.h>

   void uuid_to_string( uuid_t *uuid,
                        unsigned_char_t **string_uuid,
                        unsigned32 *status );

 PARAMETERS

   Input

   uuid  Specifies a UUID in its binary format.  Supply NULL to specify
         a nil UUID for this parameter.

   Output

   string_uuid
         Returns a pointer to the string representation of the UUID
         specified in the uuid parameter.  Specify NULL for this
         parameter to prevent the routine from returning this
         information.

   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:

         uuid_s_ok               Success.

         uuid_s_bad_version      Bad UUID version.

 DESCRIPTION

   The uuid_to_string() routine converts a UUID from its binary
   representation to its string representation.

   The RPC runtime allocates memory for the string returned in the
   string_uuid parameter. The application calls rpc_string_free() to
   deallocate that memory.  It is not necessary to call
   rpc_string_free() when you supply NULL for the string_uuid
   parameter.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: rpc_string_free
              uuid_from_string