Partilhar via


Exemplo: obter dados WMI do computador local

Você pode utilizar o procedimento e os exemplos de código neste tópico para criar um aplicativo cliente WMI completo que realiza a inicialização do COM, conecta-se ao WMI no computador local, recupera dados de forma semissíncrona e depois faz a limpeza. Este exemplo obtém o nome do sistema operacional no computador local e o exibe. Para recuperar dados de um computador remoto, consulte Exemplo: obter dados WMI de um computador remoto. Para obter os dados de forma assíncrona, consulte Exemplo: obter dados WMI do computador local de forma assíncrona.

O procedimento a seguir é usado para executar o aplicativo WMI. As etapas de 1 a 5 contêm todas as etapas necessárias para configurar e se conectar ao WMI e as etapas de 6 e 7 são onde os dados são consultados e recebidos.

  1. Inicialize parâmetros COM com uma chamada para CoInitializeEx.

    Para obter mais informações, confira Inicializar o COM para um aplicativo do WMI.

  2. Inicialize a segurança do processo COM chamando CoInitializeSecurity.

    Para obter mais informações, consulte Definir o nível de segurança do processo padrão usando C++.

  3. Obtenha o localizador inicial para o WMI chamando CoCreateInstance.

    Para obter mais informações, consulte Criar uma conexão com um namespace do WMI.

  4. Obtenha um ponteiro para IWbemServices para o namespace root\cimv2 no computador local chamando IWbemLocator::ConnectServer. Para se conectar a um computador remoto, consulte Exemplo: obter dados WMI de um computador remoto.

    Para obter mais informações, consulte Criar uma conexão com um namespace do WMI.

  5. Defina a segurança do proxy IWbemServices para que o serviço WMI possa representar o cliente chamando CoSetProxyBlanket.

    Para obter mais informações, consulte Definir níveis de segurança em uma conexão WMI.

  6. Use o ponteiro IWbemServices para fazer solicitações de WMI. Este exemplo executa uma consulta pelo nome do sistema operacional chamando IWbemServices::ExecQuery.

    A consulta WQL a seguir é um dos argumentos de método.

    SELECT * FROM Win32_OperatingSystem

    O resultado dessa consulta é armazenado em um ponteiro IEnumWbemClassObject. Isso permite que os objetos de dados da consulta sejam recuperados de forma semissíncrona com a interface IEnumWbemClassObject. Para obter mais informações, consulte Enumerar o WMI. Para obter os dados de forma assíncrona, consulte Exemplo: obter dados WMI do computador local de forma assíncrona.

    Para obter mais informações sobre como fazer solicitações ao WMI, consulte Manipular informações de classe e instância, Consultar o WMI e Chamar um método.

  7. Obtenha e exiba os dados da consulta WQL. O ponteiro IEnumWbemClassObject está vinculado aos objetos de dados que a consulta retornou e os objetos de dados podem ser recuperados com o método IEnumWbemClassObject::Next. Esse método vincula os objetos de dados a um ponteiro IWbemClassObject que é passado para o método. Use o método IWbemClassObject::Get para obter as informações desejadas dos objetos de dados.

    O exemplo de código a seguir é usado para obter a propriedade “Name” do objeto de dados, que fornece o nome do sistema operacional.

    VARIANT vtProp;
    VariantInit(&vtProp);
    // Get the value of the Name property
    hr = pclsObj->Get(L"Name", 0, &vtProp, 0, 0);
    

    Depois que o valor da propriedade Name for armazenado na variável VARIANT vtProp, ele poderá ser exibido para o usuário.

    Para obter mais informações, consulte Enumerar o WMI.

O exemplo de código a seguir recupera dados WMI de forma semissíncrona de um computador local.

#define _WIN32_DCOM
#include <iostream>
using namespace std;
#include <comdef.h>
#include <Wbemidl.h>

#pragma comment(lib, "wbemuuid.lib")

int main(int argc, char **argv)
{
    HRESULT hres;

    // Step 1: --------------------------------------------------
    // Initialize COM. ------------------------------------------

    hres =  CoInitializeEx(0, COINIT_MULTITHREADED); 
    if (FAILED(hres))
    {
        cout << "Failed to initialize COM library. Error code = 0x" 
            << hex << hres << endl;
        return 1;                  // Program has failed.
    }

    // Step 2: --------------------------------------------------
    // Set general COM security levels --------------------------

    hres =  CoInitializeSecurity(
        NULL, 
        -1,                          // COM authentication
        NULL,                        // Authentication services
        NULL,                        // Reserved
        RPC_C_AUTHN_LEVEL_DEFAULT,   // Default authentication 
        RPC_C_IMP_LEVEL_IMPERSONATE, // Default Impersonation  
        NULL,                        // Authentication info
        EOAC_NONE,                   // Additional capabilities 
        NULL                         // Reserved
        );

                      
    if (FAILED(hres))
    {
        cout << "Failed to initialize security. Error code = 0x" 
            << hex << hres << endl;
        CoUninitialize();
        return 1;                    // Program has failed.
    }
    
    // Step 3: ---------------------------------------------------
    // Obtain the initial locator to WMI -------------------------

    IWbemLocator *pLoc = NULL;

    hres = CoCreateInstance(
        CLSID_WbemLocator,             
        0, 
        CLSCTX_INPROC_SERVER, 
        IID_IWbemLocator, (LPVOID *) &pLoc);
 
    if (FAILED(hres))
    {
        cout << "Failed to create IWbemLocator object."
            << " Err code = 0x"
            << hex << hres << endl;
        CoUninitialize();
        return 1;                 // Program has failed.
    }

    // Step 4: -----------------------------------------------------
    // Connect to WMI through the IWbemLocator::ConnectServer method

    IWbemServices *pSvc = NULL;
 
    // Connect to the root\cimv2 namespace with
    // the current user and obtain pointer pSvc
    // to make IWbemServices calls.
    hres = pLoc->ConnectServer(
         _bstr_t(L"ROOT\\CIMV2"), // Object path of WMI namespace
         NULL,                    // User name. NULL = current user
         NULL,                    // User password. NULL = current
         0,                       // Locale. NULL indicates current
         NULL,                    // Security flags.
         0,                       // Authority (for example, Kerberos)
         0,                       // Context object 
         &pSvc                    // pointer to IWbemServices proxy
         );
    
    if (FAILED(hres))
    {
        cout << "Could not connect. Error code = 0x" 
             << hex << hres << endl;
        pLoc->Release();     
        CoUninitialize();
        return 1;                // Program has failed.
    }

    cout << "Connected to ROOT\\CIMV2 WMI namespace" << endl;


    // Step 5: --------------------------------------------------
    // Set security levels on the proxy -------------------------

    hres = CoSetProxyBlanket(
       pSvc,                        // Indicates the proxy to set
       RPC_C_AUTHN_WINNT,           // RPC_C_AUTHN_xxx
       RPC_C_AUTHZ_NONE,            // RPC_C_AUTHZ_xxx
       NULL,                        // Server principal name 
       RPC_C_AUTHN_LEVEL_CALL,      // RPC_C_AUTHN_LEVEL_xxx 
       RPC_C_IMP_LEVEL_IMPERSONATE, // RPC_C_IMP_LEVEL_xxx
       NULL,                        // client identity
       EOAC_NONE                    // proxy capabilities 
    );

    if (FAILED(hres))
    {
        cout << "Could not set proxy blanket. Error code = 0x" 
            << hex << hres << endl;
        pSvc->Release();
        pLoc->Release();     
        CoUninitialize();
        return 1;               // Program has failed.
    }

    // Step 6: --------------------------------------------------
    // Use the IWbemServices pointer to make requests of WMI ----

    // For example, get the name of the operating system
    IEnumWbemClassObject* pEnumerator = NULL;
    hres = pSvc->ExecQuery(
        bstr_t("WQL"), 
        bstr_t("SELECT * FROM Win32_OperatingSystem"),
        WBEM_FLAG_FORWARD_ONLY | WBEM_FLAG_RETURN_IMMEDIATELY, 
        NULL,
        &pEnumerator);
    
    if (FAILED(hres))
    {
        cout << "Query for operating system name failed."
            << " Error code = 0x" 
            << hex << hres << endl;
        pSvc->Release();
        pLoc->Release();
        CoUninitialize();
        return 1;               // Program has failed.
    }

    // Step 7: -------------------------------------------------
    // Get the data from the query in step 6 -------------------
 
    IWbemClassObject *pclsObj = NULL;
    ULONG uReturn = 0;
   
    while (pEnumerator)
    {
        HRESULT hr = pEnumerator->Next(WBEM_INFINITE, 1, 
            &pclsObj, &uReturn);

        if(0 == uReturn)
        {
            break;
        }

        VARIANT vtProp;

        VariantInit(&vtProp);
        // Get the value of the Name property
        hr = pclsObj->Get(L"Name", 0, &vtProp, 0, 0);
        wcout << " OS Name : " << vtProp.bstrVal << endl;
        VariantClear(&vtProp);

        pclsObj->Release();
    }

    // Cleanup
    // ========
    
    pSvc->Release();
    pLoc->Release();
    pEnumerator->Release();
    CoUninitialize();

    return 0;   // Program successfully completed.
 
}