/* * Copyright (c) 2010 Apple Inc. All rights reserved. * * @APPLE_LICENSE_HEADER_START@ * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. Neither the name of Apple Inc. ("Apple") nor the names of its * contributors may be used to endorse or promote products derived from * this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * Portions of this software have been released under the following terms: * * (c) Copyright 1989-1993 OPEN SOFTWARE FOUNDATION, INC. * (c) Copyright 1989-1993 HEWLETT-PACKARD COMPANY * (c) Copyright 1989-1993 DIGITAL EQUIPMENT CORPORATION * * To anyone who acknowledges that this file is provided "AS IS" * without any express or implied warranty: * permission to use, copy, modify, and distribute this file for any * purpose is hereby granted without fee, provided that the above * copyright notices and this notice appears in all source code copies, * and that none of the names of Open Software Foundation, Inc., Hewlett- * Packard Company or Digital Equipment Corporation be used * in advertising or publicity pertaining to distribution of the software * without specific, written prior permission. Neither Open Software * Foundation, Inc., Hewlett-Packard Company nor Digital * Equipment Corporation makes any representations about the suitability * of this software for any purpose. * * Copyright (c) 2007, Novell, Inc. All rights reserved. * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. Neither the name of Novell Inc. nor the names of its contributors * may be used to endorse or promote products derived from this * this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * @APPLE_LICENSE_HEADER_END@ */ /* ** ** NAME: ** ** uuid.idl ** ** FACILITY: ** ** UUID ** ** ABSTRACT: ** ** UUID Interface Definition ** ** */ [local] interface uuid { import "dce/lbase.idl"; /*************************************************************************/ /************************* Common definitions **************************/ /*************************************************************************/ /* * architectural version 1 */ const long uuid_c_version = 1; const long uuid_c_version_highest = 2; /* * A vector of UUIDs. */ typedef struct { unsigned32 count; uuid_p_t uuid[1]; } uuid_vector_t, *uuid_vector_p_t; /*************************************************************************/ /**************************** Status Codes *****************************/ /*************************************************************************/ /* moved to rpcsts.msf. See dce_error.c */ const long uuid_s_ok = error_status_ok; /* * U U I D _ C R E A T E * * Create a new UUID. */ void uuid_create ( [out] idl_uuid_t *uuid, [out] unsigned32 *status ); /* * U U I D _ C R E A T E _ N I L * * Create a 'nil' uuid */ void uuid_create_nil ( [out] idl_uuid_t *uuid, [out] unsigned32 *status ); /* * U U I D _ T O _ S T R I N G * * Convert a UUID in (non-human) UUID format to STRING format */ void uuid_to_string ( [in] uuid_p_t uuid, [out] unsigned_char_p_t *uuid_string, [out] unsigned32 *status ); /* * U U I D _ F R O M _ S T R I N G * * Convert a UUID in STRING format to a UUID in UUID format */ void uuid_from_string ( [in] unsigned_char_p_t uuid_string, [out] idl_uuid_t *uuid, [out] unsigned32 *status ); /* * U U I D _ E Q U A L * * Compare two UUIDs */ boolean32 uuid_equal ( [in] uuid_p_t uuid1, [in] uuid_p_t uuid2, [out] unsigned32 *status ); /* * U U I D _ I S _ N I L * * Return boolean true if uuid is 'nil' */ boolean32 uuid_is_nil ( [in] uuid_p_t uuid, [out] unsigned32 *status ); /* * U U I D _ C O M P A R E * * Compare two UUIDs "lexically" */ signed32 uuid_lexcompare ( [in] uuid_p_t uuid1, [in] uuid_p_t uuid2, [out] unsigned32 *status ); /* * U U I D _ H A S H * * Create a hash value for a UUID */ unsigned16 uuid_hash ( [in] uuid_p_t uuid, [out] unsigned32 *status ); }