Enumeração WbemChangeFlagEnum (wbemdisp.h)

As constantes WbemChangeFlagEnum definem como uma operação de gravação em uma classe ou uma instância é realizada. Uma operação de gravação é executada por SWbemObject.Put_ ou por SWbemServicesEx.Put_. Esses sinalizadores são usados por SWbemObject.Put_ e SWbemObject.PutAsync_.

A biblioteca de tipos de script WMI, WbemDisp.tlb, define essas constantes. Os aplicativos do Visual Basic podem acessar esta biblioteca; as linguagens de script devem usar o valor da constante diretamente, a menos que usem o formato de arquivo XML do WSH (Host de Script do Windows). Para obter mais informações, consulte Usando a biblioteca de tipos de script 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 Faz com que a classe ou instância seja criada, se ela não existir, ou substituída se ela já existir.
wbemChangeFlagUpdateOnly Valor: 0x1 Faz com que a chamada seja atualizada. A classe ou a instância precisa existir para que a chamada seja bem-sucedida.
wbemChangeFlagCreateOnly Valor: 0x2 Usado somente para criação. A chamada falhará se a classe ou instância já existir.
wbemChangeFlagUpdateCompatible Valor: 0 Permite que uma classe seja atualizada se não houver classes derivadas e se não houver instâncias dessa classe. Ele também permite atualizações em todos os casos se a alteração for apenas para qualificadores não importantes (por exemplo, o qualificador Descrição ). Se a classe tiver instâncias, a atualização falhará. Esse sinalizador é usado para compatibilidade com versões anteriores do WMI.
wbemChangeFlagUpdateSafeMode Valor: 0x20 Permite atualizações de classes mesmo que haja classes filho, desde que a alteração não cause conflitos com classes filho. Um exemplo de uma atualização que esse sinalizador permitiria seria adicionar uma nova propriedade à classe base não mencionada anteriormente em nenhuma das classes filho. Se a classe tiver instâncias, a atualização falhará.
wbemChangeFlagUpdateForceMode Valor: 0x40 Força as atualizações de classes quando há classes filho conflitantes. Um exemplo de uma atualização que esse sinalizador força seria se um qualificador de classe fosse definido em uma classe filho e a classe base tentasse adicionar o mesmo qualificador em conflito com o existente. No modo de força, esse conflito é resolvido excluindo o qualificador na classe filho. Se a classe tiver instâncias, a atualização falhará. Usar o modo de força para atualizar uma classe estática resulta na exclusão de todas as instâncias dessa classe. Forçar atualização em classes de provedor não exclui instâncias da classe .
wbemChangeFlagStrongValidation Valor: 0x80 : Notifica o sistema operacional para retornar uma falha nas operações put para quaisquer instâncias inválidas do sistema. Exemplos dessas instâncias são instâncias relacionadas a eventos, como filtros, associações ou provedores. Por padrão, se essas instâncias forem inválidas, a operação put relatará êxito, mas um erro será relatado no log.
wbemChangeFlagAdvisory Valor: 0x10000

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	wbemdisp.h

Confira também

Constantes de API de script