PreviousNext

uuid_from_string(3rpc)

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.

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

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.

uuid_s_invalid_string_uuid
Invalid format for a string UUID.

Related Information
Functions: uuid_to_string(3rpc)