| ## uuid_to_string(3rpc) 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. 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. Errors The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. uuid_s_ok Success. uuid_s_bad_version Bad UUID version. Related Information Functions: rpc_string_free(3rpc) uuid_from_string(3rpc) ##