Objeto SWbemPropertySet

Artigo
07/03/2023

Um objeto SWbemPropertySet é uma coleção de objetos SWbemProperty. Você pode adicionar itens à coleção usando o método Add, recuperar itens da coleção usando o método Item e remover itens da coleção usando o método Remove. Para obter mais informações, consulte Acessar uma coleção. Esse objeto não pode ser criado pela chamada CreateObject do VBScript.

Os objetos SWbemProperty que compõem uma coleção SWbemPropertySet são usados para descrever as propriedades de uma só classe ou instância do WMI.

Membros

O objeto SWbemPropertySet tem estes tipos de membros:

Métodos
Propriedades

Métodos

O objeto SWbemPropertySet tem esses métodos.

Método	Descrição
Adicionar	Adiciona um objeto SWbemProperty à coleção SWbemPropertySet.
Item	Obtém uma SWbemProperty nomeada da coleção. Esse é o método padrão para esse objeto.
Remover	Exclui um objeto SWbemProperty da coleção .

Propriedades

O objeto SWbemPropertySet tem essas propriedades.

Propriedade	Tipo de acesso	Descrição
Contagem	Somente leitura	O número de itens na coleção SWbemPropertySet.

Exemplos

O exemplo de VBScript a seguir demonstra como SWbemPropertySet.Remove poderá retornar wbemErrResetToDefault se a propriedade for substituída.

on error resume next 

'Create a keyed class with a defaulted property
set service = GetObject("Winmgmts:")
set emptyclass = service.Get
emptyclass.path_.class = "REMOVETEST00"
set prop = emptyclass.properties_.add ("p", 19)

prop.qualifiers_.add "key", true
emptyclass.properties_.add ("q", 19).Value = 12

emptyclass.put_

'create an instance and override the property
set instance = service.get ("RemoveTest00").spawninstance_

instance.properties_("q").Value = 24
instance.properties_("p").Value = 1
instance.put_

'retrieve the instance and remove the property
set instance = service.get ("removetest00=1")
set property = instance.properties_ ("q")

WScript.echo "Overridden value of property is [24]:", property.value
WScript.echo ""

instance.properties_.remove "q"
set property = instance.properties_ ("q")
WScript.echo "Value of property after removal is [12]:", property.value
WScript.echo ""

if err <> 0 then
 WScript.Echo "0x" & Hex(Err.Number), Err.Description, Err.Source
end if

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPropertySet
IID	IID_ISWbemPropertySet

Confira também

Criar script de objetos de API