Compartir a través de


Enumeración WbemChangeFlagEnum (wbemdisp.h)

Las constantes WbemChangeFlagEnum definen cómo se lleva a cabo una operación de escritura en una clase o una instancia. Una operación de escritura se ejecuta mediante SWbemObject.Put_ o por SWbemServicesEx.Put_. Estas marcas las usan SWbemObject.Put_ y SWbemObject.PutAsync_.

La biblioteca de tipos de scripting WMI WbemDisp.tlb define estas constantes. Las aplicaciones de Visual Basic pueden acceder a esta biblioteca; Los lenguajes de script deben usar el valor de la constante directamente, a menos que usen el formato de archivo XML del host de script de Windows (WSH). Para obtener más información, vea Usar la biblioteca de tipos de scripting de WMI.

Syntax

typedef enum WbemChangeFlagEnum {
  wbemChangeFlagCreateOrUpdate = 0,
  wbemChangeFlagUpdateOnly = 0x1,
  wbemChangeFlagCreateOnly = 0x2,
  wbemChangeFlagUpdateCompatible = 0,
  wbemChangeFlagUpdateSafeMode = 0x20,
  wbemChangeFlagUpdateForceMode = 0x40,
  wbemChangeFlagStrongValidation = 0x80,
  wbemChangeFlagAdvisory = 0x10000
} ;

Constantes

 
wbemChangeFlagCreateOrUpdate
Valor: 0
Hace que se cree la clase o instancia, si no existe o se sobrescribe si ya existe.
wbemChangeFlagUpdateOnly
Valor: 0x1
Hace que la llamada se actualice. La clase o la instancia debe existir para que la llamada se realice correctamente.
wbemChangeFlagCreateOnly
Valor: 0x2
Se usa solo para la creación. Se producirá un error en la llamada si la clase o instancia ya existe.
wbemChangeFlagUpdateCompatible
Valor: 0
Permite actualizar una clase si no hay clases derivadas y ninguna instancia de esa clase. También permite actualizaciones en todos los casos si el cambio es solo para calificadores no importantes (por ejemplo, el calificador Description ). Si la clase tiene instancias, se produce un error en la actualización. Esta marca se usa para la compatibilidad con versiones anteriores de WMI.
wbemChangeFlagUpdateSafeMode
Valor: 0x20
Permite actualizaciones de clases incluso si hay clases secundarias siempre y cuando el cambio no cause ningún conflicto con las clases secundarias. Un ejemplo de una actualización de esta marca permitiría agregar una nueva propiedad a la clase base que no se mencionó anteriormente en ninguna de las clases secundarias. Si la clase tiene instancias, se produce un error en la actualización.
wbemChangeFlagUpdateForceMode
Valor: 0x40
Fuerza las actualizaciones de clases cuando existen clases secundarias en conflicto.

Un ejemplo de una actualización que fuerza esta marca sería si un calificador de clase se definió en una clase secundaria y la clase base intentó agregar el mismo calificador en conflicto con el existente. En el modo de fuerza, este conflicto se resuelve eliminando el calificador en la clase secundaria. Si la clase tiene instancias, se produce un error en la actualización.

El uso del modo force para actualizar una clase estática da como resultado la eliminación de todas las instancias de esa clase. Forzar la actualización en las clases de proveedor no elimina instancias de la clase .
wbemChangeFlagStrongValidation
Valor: 0x80
: Notifica al sistema operativo que devuelva un error al colocar operaciones en cualquier instancia del sistema no válida. Algunos ejemplos de estas instancias son instancias relacionadas con eventos, como filtros, enlaces o proveedores. De forma predeterminada, si estas instancias no son válidas, la operación put informa de que la operación se ha realizado correctamente, pero se notifica un error en el registro.
wbemChangeFlagAdvisory
Valor: 0x10000

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Encabezado wbemdisp.h

Consulte también

Constantes de API de scripting