NAME

uuid_is_nil- determines if a UUID is a nil-valued UUID.

SYNOPSIS

#include <dce/uuid.h>

boolean32 uuid_is_nil(
	uuid_t *uuid,
	unsigned32 *status);

PARAMETERS

Input

uuid

Specifies a UUID to test for nil value.

Output

status

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

Possible status codes and their meanings include:

uuid_s_ok

Success.

DESCRIPTION

The uuid_is_nil() routine determines whether the specified UUID is a nil-valued 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-value UUID to the UUID specified in the uuid argument.

RETURN VALUE

If successful, returns one of the following constants:

TRUE

The uuid argument is a nil-valued UUID.

FALSE

The uuid argument is not a nil-valued UUID.

SEE ALSO

uuid_compare()
uuid_create_nil()
uuid_equal().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.