NAME

uuid_equal — Determines if two UUIDs are equal;  used by client, server, or management applications

Synopsis

boolean32 uuid_equal(
uuid_t ∗uuid1,
uuid_t ∗uuid2,
unsigned32 ∗status);

Parameters

Input

uuid1Specifies a pointer to a UUID. This UUID is compared with the UUID specified in uuid2.  Supply the value NULL to specify a nil UUID for this parameter. 

uuid2Specifies a pointer to a UUID. This UUID is compared with the UUID specified in uuid1.  Supply the value NULL to specify a nil UUID for this parameter. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The uuid_equal() routine compares two UUIDs and determines if they are equal. 

Return Values

The possible return values and their meanings are as follows:

TRUEThe uuid1 parameter is equal to the uuid2 parameter.  Parameter status contains the status code uuid_s_ok. 

FALSEThe uuid1 parameter is not equal to the uuid2 parameter. 

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: uuid_compare(3rpc).