NAME

   uuid_from_string - Converts a string UUID to its binary representation

   Used by client, server, or management applications.

 SYNOPSIS

   #include <dce/uuid.h>

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

 PARAMETERS

   Input

   string_uuid
         Specifies a string representation of a UUID.  Supply the value
         NULL or the null string (\0) to specify a nil UUID.

   Output

   uuid  Returns the binary form of the UUID specified by the string_uuid
         parameter into the address specified by this 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:

         uuid_s_ok    Success.

         uuid_s_bad_version
                      Bad UUID version.

         uuid_s_invalid_string_uuid
                      Invalid format for a string UUID.

 DESCRIPTION

   An application calls the uuid_from_string() routine to convert a
   string UUID to its binary representation.

 RETURN VALUES

   No value is returned.

 RELATED INFORMATION

   Functions: uuid_to_string