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)