NAME

uuid_is_nil - Determines if a UUID is nil

Used by client, server, or management applications. 

SYNOPSIS

#include <dce/uuid.h>
boolean32 uuid_is_nil(

uuid_t ∗uuid ,
unsigned32 ∗status );

PARAMETERS

Input

uuidSpecifies a UUID to test as a nil UUID.  Supply NULL to specify a nil UUID for this argument. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not.  The possible status codes and their meanings are as follows:

uuid_s_okSuccess. 

uuid_s_bad_version
Bad UUID version.

DESCRIPTION

The uuid_is_nil routine determines whether the specified UUID is a nil UUID. This routine yields the same result as if an application did the following:

       •Called the uuid_create_nil routine

       •Called the uuid_equal routine to compare the returned nil UUID to the UUID specified in the uuid argument

RETURN VALUES

The possible return values and their meanings are as follows:

trueuuid is a nil UUID.  Argument status contains the status code uuid_s_ok. 

falseuuid is not a nil UUID. 

RELATED INFORMATION

Functions: uuid_compare(3), uuid_create_nil(3), uuid_equal(3)