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

   uuid
       Specifies a UUID to test as a nil UUID.  Supply NULL to specify
       a nil UUID for this parameter.

   Output

   status
       Returns 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_ok             Success.

       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 parameter.

 RETURN VALUES

   The possible return values and their meanings are as follows:

   TRUE    The uuid parameter is a nil UUID.  Parameter status contains
           the status code uuid_s_ok.

   FALSE    The uuid parameter is not a nil UUID.

 RELATED INFORMATION

   Functions: uuid_compare
              uuid_create_nil
              uuid_equal