cmciclientft.associatornames(3) [centos man page]

3(2005-06-09)															     3(2005-06-09)

NAME

       CMCICLientFT.associatorNames() - Enumerate ObjectPaths associated with an Instance

SYNOPSIS

       #include <cmci.h>

       CMPIEnumeration*
       CMCIClientFT.associatorNames(CMCIClient*cl,
		      CMPIObjectPath*op,
		      constchar*assocClass,
		      constchar*resultClass,
		      constchar*role,
		      constchar*resultRole,
		      CMPIStatus*rc);

DESCRIPTION

       Enumerate ObjectPath references associated with the Instance defined by op reference.

       Arguments are the client object pointer cl, an ObjectPath object pointer op with the reference that contains namespace and classname compo-
       nents, assocClass, where if it's not NULL is an association class name that is used to filter the returned set  of  ObjectPath  objects	by
       eliminating  objects  that aren't associated to the source object by an instance of this class or one of its subclasses, resultClass, where
       if it's not NULL is a valid class name that is used to filter the returned set of Objects by eliminating objects that aren't an Instance of
       this  Class  or	one  of  its  subclasses, role, where if it's not NULL is a valid property name that is used to filter the returned set of
       ObjectPath objects by eliminating objects that aren't associated to the source object by an association where the source object	plays  the
       specified  role,  i.e.  the  name  of the property in the association class that refers to the source object has to match the value of this
       parameter, resultRole, where if it's not NULL is a valid property name that is used to filter the returned set  of  ObjectPath  objects	by
       eliminating  objects that aren't associated to the source object by an association where the returned object plays the specified role, i.e.
       the name of the property in the association class that refers to the returned object has to match the value of  this  parameter,  rc  which
       returns the operation status (suppressed when NULL).

       The flags argument is a bit mask that can contains the following flags - CMPI_FLAG_IncludeQualifiers and CMPI_FLAG_IncludeClassOrigin.

RETURN VALUE

       When  successful  the  CMCIClientFT.associatorNames()  function	returns a pointer to a CMPIEnumeration object that contains the ObjectPath
       objects found for the class that match the association criteria and sets a successful operation status code in rc.   When  unsuccessful	it
       returns a NULL pointer and sets the operation status error code and corresponding error string in rc.

ERRORS

EXAMPLES

CONFORMING TO

SEE ALSO

       Common Manageability Programming Interface (CMPI) - OpenGroup,
       CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIStatus(3)

SFCBroker Client Library					       sfcc							     3(2005-06-09)

Check Out this Related Man Page

3(2005-06-09)															     3(2005-06-09)

NAME

       CMCICLientFT.enumClasses() - Enumerate classes and subclasss

SYNOPSIS

       #include <cmci.h>

       CMPIEnumeration*
       CMCIClientFT.enumClasses(CMCIClient*cl,
			       CMPIObjectPath* op,
			       CMPIFlags flags,
			       CMPIStatus* rc);

DESCRIPTION

       Enumerate Classies using op as reference. The content of the returned classes can be controled using the flags parameter.

       Arguments  are the client object pointer cl, ObjectPath object pointer op that contains namespace and classname components, flags to affect
       the returned class structure content, and rc the CMPI return status (suppressed when NULL).

       The flags argument is a bit mask that can contain the flags  CMPI_FLAG_LocalOnly,  CMPI_FLAG_DeepInheritance,  CMPI_FLAG_IncludeQualifiers,
       and CMPI_FLAG_IncludeClassOrigin.

RETURN VALUE

       When  successful  the CMCIClientFT.enumClasses() function returns a pointer to a CMPIEnumeration object that contains each enumerated class
       and sets a successful status code in rc.  When unsuccessful it returns NULL and sets the rc argument with the error  code  and  and  corre-
       sponding error string.

ERRORS

EXAMPLES

	  CMCIClient *cc;
	  CMPIObjectPath * objectpath;
	  CMPIInstance * instance;
	  CMPIEnumeration * enumeration;
	  CMPIStatus status;

	  /* Setup a conncetion to the CIMOM */
	  cc = cmciConnect("localhost", NULL, NULL, NULL, NULL, NULL);

	  objectpath = newCMPIObjectPath("root/cimv2", NULL, NULL);
	  enumeration = cc->ft->enumClasses(cc, objectpath, 0, &status);

	  if   (!status.rc)  {	     fprintf(stderr,  "operation  error  code  %d  description	%s0,		     status.rc,  status.msg->hdl);
	    abort();
	  }

CONFORMING TO

SEE ALSO

       Common Manageability Programming Interface (CMPI) - OpenGroup,
       CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIFlags(3), CMPIStatus(3)

SFCBroker Client Library					       sfcc							     3(2005-06-09)

Linux and UNIX Man Pages

cmciclientft.associatornames(3) [centos man page]

Check Out this Related Man Page