NAME

       CMCIClientFT.getInstance() - Get class instance

SYNOPSIS

       #include <cmci.h>

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

DESCRIPTION

       Get  class  instance  using  op  as  reference. The content of the returned class instance
       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 instance structure
       content,
        properties array, and rc which returns the operation status (suppressed when NULL).

       The flags argument is a bit mask that can contain combinations of the  following  flags  -
       CMPI_FLAG_LocalOnly, CMPI_FLAG_IncludeQualifiers, and CMPI_FLAG_IncludeClassOrigin.

       The  properties  array  defines what properties should be returned for the class.  If this
       argument is not NULL, only the class properties in the list are returned.   If  it's  NULL
       all class properties are returned.

RETURN VALUE

       When   successful   the   CMCIClientFT.getInstance()  function  returns  a  pointer  to  a
       CMPIInstance object and sets a successful  status  code  for  rc.   When  unsuccessful  it
       returns  NULL  and  sets  the  rc argument with the error code and and corresponding error
       string.

ERRORS

EXAMPLES

CONFORMING TO

SEE ALSO

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