Método SWbemServices.Get

O método Get do objeto SWbemServices recupera um objeto, que é uma definição de classe ou uma instância, com base no caminho do objeto. Esse método recupera apenas objetos do namespace associado ao objeto SWbemServices atual.

O método é chamado no modo síncrono. Para obter mais informações, consulte Chamar um método.

Para conferir uma explicação dessa sintaxe, confira Convenções de documentação para API de script.

Sintaxe

objWbemObject = .Get( _
  [ ByVal strObjectPath ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parâmetros

strObjectPath [opcional]

Cadeia de caracteres que contém o caminho do objeto a ser recuperado. Se esse valor estiver vazio, o objeto vazio retornado poderá se tornar uma nova classe. Para obter mais informações, confira Descrever o local de um objeto do WMI.

iFlags [opcional]

Inteiro que determina o comportamento da consulta. Esse parâmetro pode aceitar os valores a seguir.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Faz com que o WMI retorne dados de aditamento da classe com a definição da classe base. Para obter mais informações sobre qualificadores alterados, confira Localizar informações de classe do WMI.

Retornar valor

Se tiver êxito, esse método retornará um objeto SWbemObject que representa o objeto solicitado.

Códigos do Erro

Após a conclusão do método Get, o objeto Err poderá conter um dos códigos de erro da lista a seguir.

wbemErrAccessDenied – 2147749891 (0x80041003)

O usuário atual não tem permissão para acessar o objeto.

wbemErrFailed – 2147749889 (0x80041001)

Erro não especificado.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Um parâmetro especificado não é válido.

wbemErrInvalidObjectPath - 2147749946 (0x8004103A)

O caminho especificado não era válido.

wbemErrNotFound – 2147749890 (0x80041002)

Não foi possível encontrar um objeto solicitado.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Não há memória suficiente para concluir a operação.

Comentários

Ao contrário dos métodos ExecQuery e InstancesOf, o método Get sempre retorna um SWbemObject que representa uma instância específica de um recurso gerenciado pelo WMI. Para obter uma instância específica de um recurso gerenciado pelo WMI usando o método Get, você deve informar o Get a instância a ser recuperada passando o caminho do objeto para o método, conforme mostrado no script a seguir.

strComputer = "."
Set objSWbemServices = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set objSWbemObject = objSWbemServices.Get("Win32_Service.Name='Messenger'")
Wscript.Echo "Name:         " & objSWbemObject.Name        & vbCrLf & _
             "Display Name: " & objSWbemObject.DisplayName & vbCrLf & _
             "Start Mode:   " & objSWbemObject.StartMode   & vbCrLf & _
             "State:        " & objSWbemObject.State

Você pode usar esse método para obter objetos singleton, como __CIMOMIdentification, que contém informações de versão sobre a instalação do WMI em execução.

Você pode examinar o repositório com uma ferramenta de exibição, como o CIM Studio, para verificar se a nova classe e instância aparecem. Para obter um exemplo de como remover uma classe e uma instância do repositório, consulte SWbemServices.Delete ou SWbemObject.Delete_.

Requisitos

Confira também

SWbemServices

SWbemObject