cmciclientft.enuminstancenames(3) [centos man page]

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

NAME

       CMCIClientFT.enumInstanceNames() - Enumerate instance names of a class

SYNOPSIS

       #include <cmci.h>

       CMPIEnumeration*
       CMCIClientFT.enumInstanceNames(CMCIClient*cl,
		      CMPIObjectPath*op,
		      CMPIStatus*rc);

DESCRIPTION

       Enumerate Instance Names of the class (and subclasses) defined by op.

       Arguments are the client object pointer cl, an ObjectPath object pointer op with the reference that contains namespace and classname compo-
       nents, and rc which returns the operation status (suppressed when NULL).

RETURN VALUE

       When successful the CMCIClientFT.enumInstanceNames() function returns a pointer to a CMPIEnumeration object that contains strings for  each
       instance  name 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->enumInstanceNames(cc, objectpath, &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), CMPIStatus(3)

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

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

NAME

       CMCICLientFT.enumClassNames() - Enumerate class names

SYNOPSIS

       #include <cmci.h>

       CMPIEnumeration*
       CMCIClientFT.enumClassNames(CMCIClient*cl,
		      CMPIObjectPath*op,
		      CMPIFlagsflags,
		      CMPIStatus*rc);

DESCRIPTION

       Get Class using op as reference. The content of the returned class structure 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 flag CMPI_FLAG_DeepInheritance.

RETURN VALUE

       When successful the CMCIClientFT.enumClassNames() function returns a pointer to a CMPIEnumeration object  that  contains  each  class  name
       found and sets a successful status code in rc.  When unsuccessful it returns NULL and sets the rc argument with the error code and and cor-
       responding error string.

ERRORS

EXAMPLES

	  CMCIClient *cc;
	  CMPIObjectPath * objectpath;
	  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->enumClassNames(cc, objectpath, 0, &status);

	  if (!status.rc) {
	    fprintf(stderr, "op 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)