13(2005-06-09)                                                    3(2005-06-09)
2
3
4

NAME

6       CMCIClientFT.referenceNames() - Enumerate association ObjectPaths for a
7       class instance
8

SYNOPSIS

10       #include <cmci.h>
11
12       CMPIEnumeration*
13       CMCIClientFT.referenceNames(CMCIClient*cl,
14                      CMPIObjectPath*op,
15                      constchar*resultClass,
16                      constchar*role,
17                      CMPIStatus*rc);
18
19

DESCRIPTION

21       Enumerate association instances that refer to the Instance  defined  by
22       the op reference.
23
24       Arguments  are  the  client  object  pointer  cl,  an ObjectPath object
25       pointer op with the reference that  contains  namespace  and  classname
26       components,  resultClass,  where if it's not NULL is a valid class name
27       that is used to filter the returned set of association objects by elim‐
28       inating  objects  that  aren't  an Instance of this Class or one of its
29       subclasses, role, where if it's not NULL is a valid property name  that
30       is  used  to filter the returned set of instance objects by eliminating
31       objects that aren't associated to the source object by  an  association
32       where  the source object plays the specified role, i.e. the name of the
33       property in the association class that refers to the source object  has
34       to  match  the value of this parameter, and rc which returns the opera‐
35       tion status (suppressed when NULL).
36

RETURN VALUE

38       When successful the CMCIClientFT.referenceNames()  function  returns  a
39       pointer to a CMPIEnumeration object that contains the class association
40       reference objects found that match the association criteria, and sets a
41       successful operation status code in rc.  When unsuccessful it returns a
42       NULL pointer and sets the operation status error code and corresponding
43       error string in rc.
44

ERRORS

EXAMPLES

CONFORMING TO

SEE ALSO

49       Common Manageability Programming Interface (CMPI) - OpenGroup,
50       CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIStatus(3)
51
52
53
54SFCBroker Client Library             sfcc                        3(2005-06-09)
Impressum