NAME

uuid_to_string — Converts a UUID from a binary representation to a string representation;  used by client, server, or management applications

Synopsis

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

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