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