Edit

WBEM_CHANGE_FLAG_TYPE enumeration (wbemcli.h)

  • Article

Contains method parameter flags.

Syntax

typedef enum tag_WBEM_CHANGE_FLAG_TYPE {
  WBEM_FLAG_CREATE_OR_UPDATE = 0,
  WBEM_FLAG_UPDATE_ONLY = 0x1,
  WBEM_FLAG_CREATE_ONLY = 0x2,
  WBEM_FLAG_UPDATE_COMPATIBLE = 0,
  WBEM_FLAG_UPDATE_SAFE_MODE = 0x20,
  WBEM_FLAG_UPDATE_FORCE_MODE = 0x40,
  WBEM_MASK_UPDATE_MODE = 0x60,
  WBEM_FLAG_ADVISORY = 0x10000
} WBEM_CHANGE_FLAG_TYPE;

Constants

 
WBEM_FLAG_CREATE_OR_UPDATE
Value: 0
The class is created if it does not exist, or overwritten if it exists already.
WBEM_FLAG_UPDATE_ONLY
Value: 0x1
The class is overwritten if it exists already, but will not be created if it does not exist.The class must exist for the call to be successful.
WBEM_FLAG_CREATE_ONLY
Value: 0x2
This flag is used for creation only. The call fails if the class already exists.
WBEM_FLAG_UPDATE_COMPATIBLE
Value: 0
This flag allows a class to be updated if there are no derived classes and there are no instances for that class. It also allows updates in all cases if the change is just to nonimportant qualifiers (for example, the Description qualifier). This is the default behavior for this call and is used for compatibility with previous versions of Windows Management. If the class has instances or changes are to important qualifiers, the update fails.
WBEM_FLAG_UPDATE_SAFE_MODE
Value: 0x20
This flag allows updates of classes even if there are child classes as long as the change does not cause any conflicts with child classes. An example of an update this flag would allow would be to add a new property to the base class that was not previously mentioned in any of the child classes. If the class has instances, the update fails.
WBEM_FLAG_UPDATE_FORCE_MODE
Value: 0x40
This flag forces updates of classes when conflicting child classes exist. An example of an update this flag would force would be if a class qualifier were defined in a child class, and the base class tried to add the same qualifier which conflicted with the existing one. In force mode, this conflict would be resolved by deleting the conflicting qualifier in the child class.
WBEM_MASK_UPDATE_MODE
Value: 0x60
A mask value that can be used to simplify testing for the other flag values.
WBEM_FLAG_ADVISORY
Value: 0x10000
Reserved for future use.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Header wbemcli.h