NAME

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

Synopsis

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 ( ) to specify a nil UUID. 

Output

uuidReturns the binary form of the UUID specified by the string_uuid parameter into the address specified by this parameter. 

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