Enumerazione WbemChangeFlagEnum (wbemdisp.h)

  • Articolo

Le costanti WbemChangeFlagEnum definiscono la modalità di esecuzione di un'operazione di scrittura in una classe o in un'istanza. Un'operazione di scrittura viene eseguita da SWbemObject.Put_ o da SWbemServicesEx.Put_. Questi flag vengono usati da SWbemObject.Put_ e SWbemObject.PutAsync_.

La libreria dei tipi di scripting WMI, WbemDisp.tlb, definisce queste costanti. Le applicazioni Visual Basic possono accedere a questa libreria; I linguaggi di script devono usare direttamente il valore della costante, a meno che non usino il formato di file XML WSH (Windows Script Host). Per altre informazioni, vedere Uso della libreria dei tipi di scripting WMI.

Sintassi

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

Costanti

 
wbemChangeFlagCreateOrUpdate
Valore: 0
Fa sì che la classe o l'istanza venga creata, se non esiste o sovrascritta se esiste già.
wbemChangeFlagUpdateOnly
Valore: 0x1
Fa sì che la chiamata venga aggiornata. La classe o l'istanza deve esistere affinché la chiamata venga eseguita correttamente.
wbemChangeFlagCreateOnly
Valore: 0x2
Utilizzato solo per la creazione. La chiamata avrà esito negativo se la classe o l'istanza esiste già.
wbemChangeFlagUpdateCompatible
Valore: 0
Consente l'aggiornamento di una classe se non sono presenti classi derivate e non sono presenti istanze per tale classe. Consente anche gli aggiornamenti in tutti i casi se la modifica è solo per qualificatori non importanti (ad esempio, qualificatore Descrizione ). Se la classe contiene istanze, l'aggiornamento ha esito negativo. Questo flag viene usato per la compatibilità con le versioni precedenti di WMI.
wbemChangeFlagUpdateSafeMode
Valore: 0x20
Consente gli aggiornamenti delle classi anche se sono presenti classi figlio, purché la modifica non causi conflitti con le classi figlio. Un esempio di aggiornamento di questo flag consente di aggiungere una nuova proprietà alla classe base non menzionata in precedenza in nessuna delle classi figlio. Se la classe contiene istanze, l'aggiornamento ha esito negativo.
wbemChangeFlagUpdateForceMode
Valore: 0x40
Forza gli aggiornamenti delle classi quando esistono classi figlio in conflitto.

Un esempio di aggiornamento di questa forza flag è se un qualificatore di classe è stato definito in una classe figlio e la classe base ha tentato di aggiungere lo stesso qualificatore in conflitto con quello esistente. Nella modalità forzata questo conflitto viene risolto eliminando il qualificatore nella classe figlio. Se la classe contiene istanze, l'aggiornamento ha esito negativo.

L'uso della modalità forza per aggiornare una classe statica comporta l'eliminazione di tutte le istanze di tale classe. Forzare l'aggiornamento nelle classi del provider non elimina le istanze della classe .
wbemChangeFlagStrongValidation
Valore: 0x80
: Notifica al sistema operativo di restituire un errore durante l'esecuzione di operazioni a qualsiasi istanza di sistema non valida. Esempi di tali istanze sono istanze correlate agli eventi, ad esempio filtri, associazioni o provider. Per impostazione predefinita, se queste istanze non sono valide, l'operazione put segnala l'esito positivo, ma viene segnalato un errore nel log.
wbemChangeFlagAdvisory
Valore: 0x10000

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Intestazione wbemdisp.h

Vedi anche

Costanti api di scripting