Criando e declarando uma instância usando C++

Você pode criar uma instância em C++ por meio da interfaceIWbemServices.

Os exemplos de código neste tópico exigem a seguinte instrução #include para compilar corretamente.

#include <wbemidl.h>

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

Para criar uma instância de uma classe existente

1. Recupere a definição da classe existente chamando o IWbemServices::GetObject ou IWbemServices::GetObjectAsync métodos.

   O exemplo de código a seguir mostra como usar o GetObject e GetObjectAsync métodos para obter um ponteiro para o IWbemClassObject interface que fornece acesso à definição de classe.

   // The pSv variable is of type IWbemServices *
   
   IWbemClassObject *pNewInstance = 0;
   IWbemClassObject *pExampleClass = 0;
   IWbemContext *pCtx = 0;
   IWbemCallResult *pResult = 0;
   
   BSTR PathToClass = SysAllocString(L"Example");
   HRESULT hRes = pSvc->GetObject(PathToClass, 0, pCtx, 
                 &pExampleClass, &pResult);
   SysFreeString(PathToClass);
   

2. Crie a nova instância chamando o IWbemClassObject::SpawnInstance método.

   O exemplo de código a seguir mostra como criar uma nova instância e, em seguida, liberar a classe.

   pExampleClass->SpawnInstance(0, &pNewInstance);
   pExampleClass->Release();  // Don't need the class any more
   

3. Defina valores para quaisquer propriedades que não herdem os valores definidos para a classe chamando o método IWbemClassObject::Put.

   Cada instância de uma classe herda todas as propriedades definidas para a classe. No entanto, você pode especificar valores de propriedade diferentes, se desejar.

   Se a classe existente tiver uma propriedade key, você deverá defini-la como NULL ou um valor exclusivo garantido. Se você definir a chave como NULL e a chave for uma cadeia de caracteres, PutInstanceAsync ou PutInstance gera e atribui internamente um GUID à chave. Dessa forma, especificar NULL para uma propriedade de chave permite criar uma instância exclusiva que não substituirá nenhuma instância anterior.

   O exemplo de código a seguir mostra como definir o valor da propriedade Index da classe de instância de exemplo.

   VARIANT v;
   VariantInit(&v);
   
   V_VT(&v) = VT_BSTR;
   V_BSTR(&v) = SysAllocString(L"IX100");
   
   BSTR KeyProp = SysAllocString(L"Index");
   pNewInstance->Put(KeyProp, 0, &v, 0);
   SysFreeString(KeyProp);
   VariantClear(&v);
   

4. Para definir os valores de quaisquer qualificadores relevantes, faça uma chamada para IWbemClassObject::GetQualifierSet.

   O GetQualifierSet método retorna um ponteiro para um interface de IWbemQualifierSet, que usa para acessar os qualificadores de uma classe ou instância. Você pode especificar valores diferentes para um qualificador definido na classe se o tipo de qualificador da classe for EnableOverride. Não é possível modificar ou excluir um qualificador de classe com o sabor definido como DisableOverride. Para obter mais informações, consulte Qualifier Flavors.

   Como opção, você também pode definir qualificadores adicionais para sua classe de instância. Você pode definir qualificadores adicionais para a instância ou para a propriedade da instância, que não precisam aparecer na declaração de classe.

5. Salve a instância chamando o IWbemServices::P utInstance ou método de IWbemServices::P utInstanceAsync.

   O WMI salva a instância no namespace WMI atual. Como tal, o caminho completo da instância depende do namespace, que normalmente é root\default. Para este exemplo de código, o nome completo do caminho seria \\.\root\default:Example.Index="IX100".

   O exemplo de código a seguir mostra como salvar uma instância.

       hRes = pSvc->PutInstance(pNewInstance, 0, pCtx, &pResult);
       pNewInstance->Release();
   

Salvar a instância no WMI bloqueia várias das propriedades da instância.

Especificamente, você não pode executar nenhuma das seguintes operações por meio da API WMI depois que uma instância existir na infraestrutura WMI:

• Altere a classe super da classe à qual a instância pertence.
• Adicione ou remova propriedades.
• Altere os tipos de propriedade.
• Adicione ou remova os qualificadores de Chave ou de Indexado.
• Adicione ou remova qualificadores Singleton, Dynamic , ou Abstract .

O exemplo de código a seguir combina os exemplos de código discutidos no procedimento anterior para mostrar como criar uma instância usando a API WMI.

void CreateInstance (IWbemServices *pSvc)
{
    IWbemClassObject *pNewInstance = 0;
    IWbemClassObject *pExampleClass = 0;
    IWbemContext *pCtx = 0;
    IWbemCallResult *pResult = 0;

    // Get the class definition.
    BSTR PathToClass = SysAllocString(L"Example");
    HRESULT hRes = pSvc->GetObject(PathToClass, 0, pCtx, 
                 &pExampleClass, &pResult);
    SysFreeString(PathToClass);

    if (hRes != 0)
       return;

    // Create a new instance.
    pExampleClass->SpawnInstance(0, &pNewInstance);
    pExampleClass->Release();  // Don't need the class any more

    VARIANT v;
    VariantInit(&v);

    // Set the Index property (the key).
    V_VT(&v) = VT_BSTR;
    V_BSTR(&v) = SysAllocString(L"IX100");

    BSTR KeyProp = SysAllocString(L"Index");
    pNewInstance->Put(KeyProp, 0, &v, 0);
    SysFreeString(KeyProp);
    VariantClear(&v);

    // Set the IntVal property.
    V_VT(&v) = VT_I4;
    V_I4(&v) = 1001;  
    
    BSTR Prop = SysAllocString(L"IntVal");
    pNewInstance->Put(Prop, 0, &v, 0);
    SysFreeString(Prop);
    VariantClear(&v);    
    
    // Other properties acquire the 'default' value specified
    // in the class definition unless otherwise modified here.

    // Write the instance to WMI. 
    hRes = pSvc->PutInstance(pNewInstance, 0, pCtx, &pResult);
    pNewInstance->Release();
}