(file) Return to CIMAssociationProvider.h CVS log (file) (dir) Up to [Pegasus] / pegasus / src / Pegasus / Provider

Diff for /pegasus/src/Pegasus/Provider/CIMAssociationProvider.h between version 1.15 and 1.16

version 1.15, 2003/05/09 15:37:54 version 1.16, 2003/09/24 18:38:23
Line 54 
Line 54 
     CIMAssociationProvider(void);     CIMAssociationProvider(void);
     virtual ~CIMAssociationProvider(void);     virtual ~CIMAssociationProvider(void);
  
     /** to enumerate CIM Objects (Instances only) that are associated to a      /** Enumerates CIM Objects (Instances only) that are associated to a
      *  particular source CIM Object       *  particular source CIM Object. Returns CIM Objects. NOTE: if the objects
            *  do not include the host and namespace information this information will
            *  be inserted by the CIMOM based on the name of the host in which the cimom
            *  resides and the namespace in the request.
  
     @param context contains security and locale information relevant for the lifetime     @param context contains security and locale information relevant for the lifetime
         of this operation.         of this operation.
Line 64 
Line 67 
      *  whose associated Objects are to be returned. This may be either a Class name      *  whose associated Objects are to be returned. This may be either a Class name
      *  or Instance name (CIMObjectpath).      *  or Instance name (CIMObjectpath).
  
      * @param associationClass - The AssocClass input parameter, if not NULL, MUST be a       @param associationClass - The AssocClass input parameter, if not NULL, MUST be a
      *  valid CIM Association Class name. It acts as a filter on the returned set of      *  valid CIM Association Class name. It acts as a filter on the returned set of
      *  Objects by mandating that each returned Object MUST be associated to the source      *  Objects by mandating that each returned Object MUST be associated to the source
      *  Object via an Instance of this Class or one of its subclasses.      *  Object via an Instance of this Class or one of its subclasses.
  
      * @param resultClass - if not NULL, MUST be a valid CIM Class name. It acts as a filter       @param resultClass - if not NULL, MUST be a valid CIM Class name. It acts as a filter
      *  on the returned set of Objects by mandating that each returned Object MUST be      *  on the returned set of Objects by mandating that each returned Object MUST be
      *  either an Instance of this Class (or one of its subclasses).      *  either an Instance of this Class (or one of its subclasses).
  
      * @param role - , if not NULL, MUST be a valid Property name. It acts as a filter on       @param role - , if not NULL, MUST be a valid Property name. It acts as a filter on
      *  the returned set of Objects by mandating that each returned Object MUST be      *  the returned set of Objects by mandating that each returned Object MUST be
      *  associated to the source Object via an Association in which the source Object      *  associated to the source Object via an Association in which the source Object
      *  plays the specified role (i.e. the name of the Property in the Association Class      *  plays the specified role (i.e. the name of the Property in the Association Class
      *  that refers to the source Object MUST match the value of this parameter).      *  that refers to the source Object MUST match the value of this parameter).
  
      * @param resultRole -  If not NULL, MUST be a valid Property name. It acts as a       @param resultRole -  If not NULL, MUST be a valid Property name. It acts as a
      *  filter on the returned set of Objects by mandating that each returned Object      *  filter on the returned set of Objects by mandating that each returned Object
      *  MUST be associated to the source Object via an Association in which the      *  MUST be associated to the source Object via an Association in which the
      *  returned Object plays the specified role (i.e. the name of the Property in      *  returned Object plays the specified role (i.e. the name of the Property in
      *  the Association Class that refers to the returned Object MUST match the      *  the Association Class that refers to the returned Object MUST match the
      *  value of this parameter).      *  value of this parameter).
  
      * @param includeQualifiers - If true, this specifies that all Qualifiers for each       @param includeQualifiers - If true, this specifies that all Qualifiers for each
      *  Object (including Qualifiers on the Object and on any returned Properties)      *  Object (including Qualifiers on the Object and on any returned Properties)
      *  MUST be included as <QUALIFIER> elements in the response. If false no      *  MUST be included as <QUALIFIER> elements in the response. If false no
      *  <QUALIFIER> elements are present in each returned Object.      *  <QUALIFIER> elements are present in each returned Object.
Line 95 
Line 98 
      *  MUST be present on all appropriate elements in each returned Object.      *  MUST be present on all appropriate elements in each returned Object.
      *  If false, no CLASSORIGIN attributes are present in each returned Object.      *  If false, no CLASSORIGIN attributes are present in each returned Object.
  
      * @param propertyList - If not NULL, the members of the array define one or more       @param propertyList - If not NULL, the members of the array define one or more
      *  Property names. Each returned Object MUST NOT include elements for any      *  Property names. Each returned Object MUST NOT include elements for any
      *  Properties missing from this list. If the PropertyList input parameter      *  Properties missing from this list. If the PropertyList input parameter
      *  is an empty array this signifies that no Properties are included in each      *  is an empty array this signifies that no Properties are included in each
Line 122 
Line 125 
         ObjectResponseHandler & handler) = 0;         ObjectResponseHandler & handler) = 0;
  
     /**  enumerate the names of CIM Objects (Instances) associated to a     /**  enumerate the names of CIM Objects (Instances) associated to a
      *  particular source CIM Object.       *   particular source CIM Object. Returns multiple CIMObjectPath objects
            *  through the handler. The returned CIMObjectPaths are expected to be
            *  absolute including host name and namespace.  If these fields are not
            *  supplied by the provider they will be inserted by the CIMOM based on
            *  the host in which the CIMOM resides and the namespace in the request.
  
     @param context contains security and locale information relevant for the lifetime     @param context contains security and locale information relevant for the lifetime
         of this operation.         of this operation.
  
     @param objectName      @param objectName -  The ObjectName input parameter defines the source CIM Object
     @param associationClass       *  whose associated Objects are to be returned. This may be either a Class name
     @param resultClass       *  or Instance name (CIMObjectpath).
     @param role  
     @param resultRole       @param associationClass - The AssocClass input parameter, if not NULL, MUST be a
        *  valid CIM Association Class name. It acts as a filter on the returned set of
        *  Objects by mandating that each returned Object MUST be associated to the source
        *  Object via an Instance of this Class or one of its subclasses.
   
        @param resultClass - if not NULL, MUST be a valid CIM Class name. It acts as a filter
        *  on the returned set of Objects by mandating that each returned Object MUST be
        *  either an Instance of this Class (or one of its subclasses).
   
        @param role - , if not NULL, MUST be a valid Property name. It acts as a filter on
        *  the returned set of Objects by mandating that each returned Object MUST be
        *  associated to the source Object via an Association in which the source Object
        *  plays the specified role (i.e. the name of the Property in the Association Class
        *  that refers to the source Object MUST match the value of this parameter).
   
        @param resultRole -  If not NULL, MUST be a valid Property name. It acts as a
        *  filter on the returned set of Objects by mandating that each returned Object
        *  MUST be associated to the source Object via an Association in which the
        *  returned Object plays the specified role (i.e. the name of the Property in
        *  the Association Class that refers to the returned Object MUST match the
        *  value of this parameter).
  
     @param handler asynchronously processes the results of this operation.     @param handler asynchronously processes the results of this operation.
  
Line 147 
Line 174 
         const String & resultRole,         const String & resultRole,
         ObjectPathResponseHandler & handler) = 0;         ObjectPathResponseHandler & handler) = 0;
  
     /** Enumerate the association object names that refer to a particular target CIM Object      /** Enumerate the association objects that refer to a particular target CIM Object
      * (Instance).       * (Instance).  Returns multiple CIMObjectPath objects
            *  through the handler. The returned CIMObjectPaths are expected to be
            *  absolute including host name and namespace.  If these fields are not
            *  supplied by the provider they will be inserted by the CIMOM based on
            *  the host in which the CIMOM resides and the namespace in the request.
   
     @param context contains security and locale information relevant for the lifetime     @param context contains security and locale information relevant for the lifetime
         of this operation.         of this operation.
  
Line 166 
Line 198 
      * source Object plays the specified role (i.e. the name of the Property      * source Object plays the specified role (i.e. the name of the Property
      *  in the Association Class that refers to the source Object MUST match the value      *  in the Association Class that refers to the source Object MUST match the value
      * of this parameter.      * of this parameter.
   
       @param resultRole -  If not NULL, MUST be a valid Property name. It acts as a
        *  filter on the returned set of Objects by mandating that each returned Object
        *  MUST be associated to the source Object via an Association in which the
        *  returned Object plays the specified role (i.e. the name of the Property in
        *  the Association Class that refers to the returned Object MUST match the
        *  value of this parameter).
   
        @param includeQualifiers - If true, this specifies that all Qualifiers for each
        *  Object (including Qualifiers on the Object and on any returned Properties)
        *  MUST be included as <QUALIFIER> elements in the response. If false no
        *  <QUALIFIER> elements are present in each returned Object.
   
        @param includeClassOrigin - If true, this specifies that the CLASSORIGIN attribute
        *  MUST be present on all appropriate elements in each returned Object.
        *  If false, no CLASSORIGIN attributes are present in each returned Object.
      *      *
     @param resultRole       @param propertyList - If not NULL, the members of the array define one or more
     @param includeQualifiers       *  Property names. Each returned Object MUST NOT include elements for any
     @param includeClassOrigin       *  Properties missing from this list. If the PropertyList input parameter
     @param propertyList       *  is an empty array this signifies that no Properties are included in each
        *  returned Object. If the PropertyList input parameter is NULL this specifies
        *  that all Properties (subject to the conditions expressed by the other
        *  parameters) are included in each returned Object.
  
     @param handler asynchronously processes the results of this operation.     @param handler asynchronously processes the results of this operation.
  
Line 188 
Line 239 
         ObjectResponseHandler & handler) = 0;         ObjectResponseHandler & handler) = 0;
  
     /** Enumerate the association object names that refer to a particular target CIM Object     /** Enumerate the association object names that refer to a particular target CIM Object
      * (Instance).       * (Instance). Returns CIMOobjectPath objects via the handler.
            * The returned CIMObjectPaths are expected to be
            * absolute including host name and namespace.  If these fields are not
            * supplied by the provider they will be inserted by the CIMOM based on
            * the host in which the CIMOM resides and the namespace in the request.
   
     @param context contains security and locale information relevant for the lifetime     @param context contains security and locale information relevant for the lifetime
     of this operation.     of this operation.
  

Legend:
Removed from v.1.15  
changed lines
  Added in v.1.16
No CVS admin address has been configured
 Powered by
ViewCVS 0.9.2