示例：从本地计算机获取 WMI 数据

项目
03/11/2025

可以使用本主题中的过程和代码示例创建一个完整的 WMI 客户端应用程序，该应用程序执行 COM 初始化、连接到本地计算机上的 WMI、检索数据半同步，然后清理。此示例获取本地计算机上的作系统的名称并显示它。若要从远程计算机检索数据，请参阅示例：从远程计算机获取 WMI 数据。有关异步获取数据，请参阅示例：从本地计算机异步获取 WMI 数据。

以下过程用于执行 WMI 应用程序。步骤 1 到 5 包含设置和连接到 WMI 所需的所有步骤，步骤 6 和 7 是查询和接收数据的位置。

使用调用 CoInitializeEx初始化 COM 参数。

有关详细信息，请参阅 WMI 应用程序初始化 COM。
通过调用 CoInitializeSecurity初始化 COM 进程安全性。

有关详细信息，请参阅使用C++设置默认进程安全级别。
通过调用 CoCreateInstance获取 WMI 的初始定位符。

有关详细信息，请参阅创建与 WMI 命名空间的连接。
通过调用 IWbemLocator：：ConnectServer，获取指向本地计算机上的 root\cimv2 命名空间 IWbemServices 的指针。若要连接到远程计算机，请参阅示例：从远程计算机获取 WMI 数据。

有关详细信息，请参阅创建与 WMI 命名空间的连接。
设置 IWbemServices 代理安全性，以便 WMI 服务可以通过调用 CoSetProxyBlanket模拟客户端。

有关详细信息，请参阅设置 WMI 连接的安全级别。
使用 IWbemServices 指针发出 WMI 的请求。此示例通过调用 IWbemServices：：ExecQuery来执行作系统名称的查询。

以下 WQL 查询是方法参数之一。

SELECT * FROM Win32_OperatingSystem

此查询的结果存储在 IEnumWbemClassObject 指针中。这样，就可以使用 IEnumWbemClassObject 接口以分同步检索查询中的数据对象。有关详细信息，请参阅枚举 WMI。有关异步获取数据，请参阅示例：从本地计算机异步获取 WMI 数据。

有关向 WMI 发出请求的详细信息，请参阅作类和实例信息、查询 WMI，以及调用方法。
从 WQL 查询获取和显示数据。 IEnumWbemClassObject 指针链接到查询返回的数据对象，可以使用 IEnumWbemClassObject：：Next 方法检索数据对象。此方法将数据对象链接到传入方法的 IWbemClassObject 指针。使用 IWbemClassObject：：Get 方法从数据对象获取所需的信息。

下面的代码示例用于从提供作系统名称的数据对象获取 Name 属性。
```
VARIANT vtProp;
VariantInit(&vtProp);
// Get the value of the Name property
hr = pclsObj->Get(L"Name", 0, &vtProp, 0, 0);
```
在 VARIANT 变量 vtProp 中存储 Name 属性的值后，可以向用户显示该属性。

有关详细信息，请参阅枚举 WMI。

下面的代码示例从本地计算机半异步检索 WMI 数据。

#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.
 
}

通过

示例：从本地计算机获取 WMI 数据

反馈

其他资源