Partager via


CIM_ServiceAffectsElement class

Represents an association between a service and the managed elements that might be affected by its execution. Instantiating this association indicates that running the service may change, manage, or pose some burden on the managed element. This burden might affect performance, throughput, availability, and so on.

Important  The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

The following syntax is simplified from Managed Object Format (MOF) code.

Syntax

class CIM_ServiceAffectsElement
{
  CIM_ManagedElement REF AffectedElement;
  CIM_Service        REF AffectingElement;
  uint16                 ElementEffects[];
  string                 OtherElementEffectsDescriptions[];
};

Members

The CIM_ServiceAffectsElement class has these types of members:

  • Properties

Properties

The CIM_ServiceAffectsElement class has these properties.

AffectedElement

Data type: CIM_ManagedElement

Access type: Read-only

Qualifiers: Key

The managed element that is affected by the service.

AffectingElement

Data type: CIM_Service

Access type: Read-only

Qualifiers: Key

The service that is affecting the managed element.

ElementEffects

Data type: uint16 array

Access type: Read-only

An enumeration that describes the effect on the managed element. This array corresponds to the OtherElementEffectsDescriptions array, where the latter provides details that are related to the high-level effects enumerated by this property. Additional detail is required if the ElementEffects array contains the value 1 (Other).

Value Meaning
Unknown 0
Other 1
Exclusive Use 2

No other service may have this association to the element.

Performance Impact 3

Deprecated in favor of "Consumes", "Enhances Performance", or "Degrades Performance". Execution of the service may enhance or degrade the performance of the element. This may be as a side-effect of execution or as an intended consequence of methods provided by the service.

Element Integrity 4

Deprecated in favor of "Consumes", "Enhances Integrity", or "Degrades Integrity". Execution of the service may enhance or degrade the integrity of the element. This may be as a side-effect of execution or as an intended consequence of methods provided by the service.

Manages 5

The Service manages the element.

Consumes 6

Execution of the service consumes some or all of the associated element as a consequence of running the Service. For example, the service may consume CPU cycles, which may affect performance, or storage which may affect both performance and integrity. (For example, the lack of free storage can degrade integrity by reducing the ability to save state.) "Consumes" may be used alone or in conjunction with other values, in particular, "Degrades Performance" and "Degrades Integrity". "Manages" and not "Consumes" should be used to reflect allocation services that may be provided by a service.

Enhances Integrity 7

The service may enhance integrity of the associated element.

Degrades Integrity 8

The service may degrade integrity of the associated element.

Enhances Performance 9

The service may enhance performance of the associated element.

Degrades Performance 10

The service may degrade performance of the associated element.

 

OtherElementEffectsDescriptions

Data type: string array

Access type: Read-only

Provides details for the effect at the corresponding array position in ElementEffects. This information is required if ElementEffects contains the value 1 (Other).

Requirements

Namespace

Root\CIMV2