次の方法で共有


例: ローカル コンピューターから WMI データを取得する

このトピックの手順とコード例を使用して、COM の初期化を実行し、ローカル コンピューター上の WMI に接続して、データを半同期的に取得し、クリーンアップを行う完全な WMI クライアント アプリケーションを作成できます。 次の使用例は、ローカル コンピューター上のオペレーティング システムの名前を取得して表示します。 リモート コンピューターからデータを取得するには、「例: リモート コンピューターから WMI データを取得する」を参照してください。 データを非同期的に取得する方法については、「例: ローカル コンピューターから WMI データを非同期的に取得する」を参照してください。

次の手順は WMI アプリケーションを実行するために使用します。 手順 1 から 5 には、WMI の設定と接続に必要なすべての手順が含まれており、手順 6 と 7 はデータのクエリと受信を行う場所です。

  1. CoInitializeEx を呼び出して COM パラメーターを初期化します。

    詳細については、「WMI アプリケーションの COM の初期化」を参照してください。

  2. CoInitializeSecurity を呼び出して COM プロセスのセキュリティを初期化します。

    詳細については、「C++ を使用した既定のプロセス セキュリティ レベルの設定」を参照してください。

  3. CoCreateInstance を呼び出して、WMI への初期ロケーターを取得します。

    詳細については、「WMI 名前空間への接続の作成」を参照してください。

  4. IWbemLocator::ConnectServer を呼び出して、ローカル コンピューター上の root\cimv2 名前空間の IWbemServices へのポインターを取得します。 リモート コンピューターに接続するには、「例: リモート コンピューターから WMI データを取得する」を参照してください。

    詳細については、「WMI 名前空間への接続の作成」を参照してください。

  5. WMI サービスが CoSetProxyBlanket を呼び出してクライアントを偽装できるように、IWbemServices プロキシ セキュリティを設定します。

    詳細については、「WMI 接続でのセキュリティ レベルの設定」を参照してください。

  6. WMI の要求を行うには、IWbemServices ポインターを使用します。 この例では、IWbemServices::ExecQuery を呼び出して、オペレーティング システムの名前のクエリを実行します。

    次の WQL クエリは、メソッド引数の 1 つです。

    SELECT * FROM Win32_OperatingSystem

    このクエリの結果は、IEnumWbemClassObject ポインターに格納されます。 これにより、IEnumWbemClassObject インターフェイスを使用してクエリからのデータ オブジェクトを半同期的に取得できます。 詳細については、「WMI の列挙」を参照してください。 データを非同期的に取得する方法については、「例: ローカル コンピューターから WMI データを非同期的に取得する」を参照してください。

    WMI への要求の詳細については、「クラスとインスタンス情報の操作」、「WMI のクエリ」、「メソッドの呼び出し」を参照してください。

  7. 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);
    

    Name プロパティの値が VARIANT 変数 vtProp に格納されたら、それをユーザーに表示できます。

    詳細については、「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.
 
}