Descrever um caminho de objeto de instância

  • Artigo

Um caminho de objeto de instância descreve o local de uma instância de uma determinada classe em um namespace específico.

Você pode ter vários tipos diferentes de caminhos de objeto de instância:

  • Completo

    Um caminho completo de objeto de instância anexa o nome e o valor da propriedade de chave da classe a um caminho completo de objeto de classe.

    O exemplo a seguir mostra a definição do caminho completo do objeto de instância.

    \\Server\Namespace:Class.KeyName="KeyValue"

  • Relativo

    Um caminho relativo do objeto refere-se a uma instância localizada no namespace atual no servidor atual. O caminho relativo consiste no nome da classe seguido pelos nomes e valores das propriedades de chave dessa instância.

    O exemplo a seguir mostra a definição do caminho relativo do objeto de instância.

    MyClass.MyProp="e:"

  • Relativo com uma única chave

    Para classes com apenas uma propriedade designada como chave, você pode omitir o nome da propriedade de chave.

    O exemplo a seguir mostra a definição do caminho relativo do objeto de instância com uma única chave.

    MyClass="e:"

  • Relativo com várias chaves

    Use a vírgula para distinguir entre as chaves de uma instância com múltiplas chaves.

    O exemplo a seguir mostra as definições do caminho relativo do objeto de instância com várias chaves.

    MyOtherClass.FirstKey=1,SecondKey=2

  • Relativo para uma classe singleton

    O caminho do objeto relativo para uma classe singleton consiste no nome da classe seguido pela notação "=@".

    O exemplo a seguir mostra a definição do caminho relativo do objeto de instância para uma classe singleton.

    MySingletonClass=@

O procedimento a seguir descreve como recuperar uma instância de classe.

Para recuperar uma instância de classe

  1. Inicialize uma cadeia de caracteres que contém o caminho do objeto com uma chamada para a função SysAllocString.

  2. Inicialize um objeto que receberá a instância.

  3. Recupere o objeto com uma chamada para IWbemServices::GetObject ou IWbemServices::GetObjectAsync.

    Para usar GetObjectAsync, você deve implementar a interface IWbemSink.

A instrução #include a seguir é necessária para que o código listado posteriormente neste tópico seja compilado corretamente.

#include <wbemidl.h>

O exemplo de código a seguir descreve como recuperar uma instância de classe usando um caminho de objeto.

IWbemServices* pWbemSvcs = 0;

BSTR Path = SysAllocString(L"ComPort=2");    
IWbemClassObject *pComPort = 0;
pWbemSvcs->GetObject(Path, 0, 0, &pComPort, 0);

Para instâncias de classes que especificam várias propriedades como a chave, o WMI não exige nenhuma ordenação específica de propriedades de chave nos caminhos de objeto. Você só precisa especificar o valor de cada uma das propriedades no caminho do objeto.

O exemplo de código a seguir apresenta duas descrições de chave equivalentes.

MyClass.IntVal=33,StrVal="AAA"
MyClass.StrVal="AAA",IntVal=33