cmpiinstance(3) [centos man page]

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

NAME

       CMPIInstance - CMPIInstance class implementation

SYNOPSIS

   Public Attributes
       int void * hdl
	   Opaque pointer to class instance data.
       CMPIInstanceFT * ft
	   Pointer to the Args Function Table.

METHODS

   CMPIStatus(* release )(CMPIInstance *inst)
       The Instance object will not be used any further and may be freed by CMPI run time system.
   CMPIInstance *(* clone )(CMPIInstance *inst, CMPIStatus *rc)
       Create an independent copy of this Instance object.
   CMPIData(* getProperty )(CMPIInstance *inst, const char *name, CMPIStatus *rc)
       Gets a named property value.
   CMPIData(* getPropertyAt )(CMPIInstance *inst, unsigned int index, CMPIString **name, CMPIStatus *rc)
       Gets a Property value defined by its index.
   unsigned int(* getPropertyCount )(CMPIInstance *inst, CMPIStatus *rc)
       Gets the number of properties contained in this Instance.
   CMPIStatus(* setProperty )(CMPIInstance *inst, const char *name, CMPIValue *value, CMPIType type)
       Adds/replaces a named Property.
   CMPIObjectPath *(* getObjectPath )(CMPIInstance *inst, CMPIStatus *rc)
       Generates an ObjectPath out of the namespace, classname and key propeties of this Instance.
   CMPIStatus(* setPropertyFilter )(CMPIInstance *inst, char **propertyList, char **keys)
       Directs CMPI to ignore any setProperty operations for this instance for any properties not in this list.

DESCRIPTION

       Native CMPIInstance implementation.

       This  is  the  native CMPIInstance implementation as used for remote providers. It reflects the well-defined interface of a regular CMPIIn-
       stance, however, it works independently from the management broker.

       It is part of a native broker implementation that simulates CMPI data types rather than interacting  with  the  entities  in  a	full-grown
       CIMOM.

SEE ALSO

       Common Manageability Programming Interface (CMPI) - OpenGroup

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

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

NAME

       CMCIClientFT.enumInstances() - Enumerate instances of a class

SYNOPSIS

       #include <cmci.h>

       CMPIEnumeration*
       CMCIClientFT.enumInstances(CMCIClient*cl,
		      CMPIObjectPath*op,
		      CMPIFlagsflags,
		      char**properties,
		      CMPIStatus*rc);

DESCRIPTION

       Enumerate  Instances  of the class (and subclasses) defined by op.  The instance structure and inheritance scope can be controled using the
       flags argument.

       Arguments are the client object pointer cl, an ObjectPath object pointer op with the reference that contains namespace and classname compo-
       nents, flags that affect the content of the returned class instance structures, a properties array, and rc which returns the operation sta-
       tus (suppressed when NULL).

       The flags argument is a bit mask that can contains the following flags - CMPI_FLAG_LocalOnly, CMPI_FLAG_DeepInheritance, CMPI_FLAG_Include-
       Qualifiers and CMPI_FLAG_IncludeClassOrigin.

RETURN VALUE

       When  successful  the CMCIClientFT.enumInstances() function returns a pointer to a CMPIEnumeration object that contains the class instances
       found for the class 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

	  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->enumInstances(cc, objectpath, 0, NULL, &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)