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

uuidSpecifies a UUID in its binary format.  Supply NULL to specify a nil UUID for this argument. 

Output

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

statusReturns 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_okSuccess. 

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 argument. The application calls the rpc_string_free routine to deallocate that memory. It is not necessary to call the rpc_string_free routine when you supply NULL for the string_uuid argument. 

RETURN VALUES

None. 

RELATED INFORMATION

Functions: rpc_string_free(3), uuid_from_string(3)