1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef	_COMMON_FUNCTIONS_H
28 #define	_COMMON_FUNCTIONS_H
29 
30 #pragma ident	"%Z%%M%	%I%	%E% SMI"
31 
32 #ifdef	__cplusplus
33 extern "C" {
34 #endif
35 
36 #include <cimapi.h>
37 
38 /*
39  * Method declaration
40  */
41 
42 /*
43  * Method: create_association_instList
44  *
45  * Description: This method creates instances of the association <pClassName>
46  * out of the <pObjectName> and <pObjPathList> parameters.  The roles of
47  * <pObjectName> and <pObjPathList> are defined by <pObjectNameRole> and
48  * <pRole> respectively.
49  *
50  * Parameters:
51  * cimchar *pClassName - The name of the association class of which to create
52  * 	the instances of.
53  * CCIMObjectPath *pObjectName - One of the association keys that will is to be
54  *	associated to one or more objects.
55  * cimchar *pObjectNameRole - The role of <pObjectName> in the association.
56  *	For example, this could be "Antecedent", "Dependent", "Element", etc.
57  * CCIMObjectPathList *pObjPathList - The other association keys that will
58  * be associated to <pObjectName>.
59  * cimchar *pRole - The role of <pObjPathList> in the association.
60  * int *errp - The error pointer.
61  *
62  * Returns:
63  * An instance list filled with instances of the <pClassName> association.
64  */
65 CCIMInstanceList	*create_association_instList(cimchar *pClassName,
66 				CCIMObjectPath *pObjectName,
67 				cimchar *pObjectNameRole,
68 				CCIMObjectPathList *pObjPathList,
69 				cimchar *pRole, int *errp);
70 
71 #ifdef __cplusplus
72 }
73 #endif
74 
75 #endif /* _COMMON_FUNCTIONS_H */
76