アプリケーションへのプロバイダーの組み込み

[アーティクル]
06/29/2023

インストルメント化するアプリケーションを作成する際は、プロバイダーをアプリケーション自体にコンポーネントとして追加する方法が推奨されています。この方法により、Windows Management Instrumentation (WMI) は、プログラム API を介して間接的にではなく、サービスプロバイダーと直接やり取りすることができます。また、WMI からプロバイダーを切り離すことで、WMI の代わりにアプリケーションがプロバイダーの有効期間を制御できるようになります。 WMI プロセス内で動作するプロバイダーの作成については、「プロバイダーを記述して WMI にデータを提供する」を参照してください。プロバイダーのホスティングモデルとセキュリティ設定の詳細については、「プロバイダーのホスティングとセキュリティ」を参照してください。

次の図は、WMI、分離プロバイダー、アプリケーションの関係を示しています。

WMI、分離プロバイダー、アプリケーション間の関係

分離プロバイダーのメソッドの詳細については、IWbemDecoupledRegistrar と IWbemDecoupledBasicEventProvider に関する記事を参照してください。

注意

分離プロバイダーは、インスタンス、メソッド、イベントプロバイダー、イベントコンシューマーをサポートします。クラスおよびプロパティプロバイダーはサポートされません。詳細については、「クラスプロバイダーの記述」および「プロパティプロバイダーの記述」を参照してください。

このトピックのコード例を正しくコンパイルするには、次の参照と #include ステートメントが必要です。

#define _WIN32_DCOM
#include <iostream>
using namespace std;
#include <comdef.h>
#include <wbemidl.h>
#pragma comment(lib, "wbemuuid.lib")

以下の手順では、C++ のコード例を使用して、分離プロバイダーをアプリケーションに組み込む方法を説明しています。登録済みの分離プロバイダーとのみ WMI が対話するように、アプリケーションの初期化メソッドで次の手順を実行します。

分離プロバイダーを C++ アプリケーションに実装するには

呼び出し元のスレッドで使用する COM ライブラリを初期化します。

COM ライブラリを初期化する方法を次のコード例に示します。
```
HRESULT hr = S_OK ;
hr = CoInitializeEx (0, COINIT_MULTITHREADED );
```
既定のプロセスセキュリティレベルを設定します。

このレベルにより、他のプロセスがクライアントプロセスの情報にアクセスするために必要なセキュリティレベルが確立されます。認証レベルは RPC_C_AUTHN_LEVEL_DEFAULT にする必要があります。詳細については、「WMI セキュリティの維持」を参照してください。

次のコード例に、既定のセキュリティレベルを設定する方法を示します。
```
hr = CoInitializeSecurity (NULL, 
    -1, 
    NULL, 
    NULL,
    RPC_C_AUTHN_LEVEL_DEFAULT,
    RPC_C_IMP_LEVEL_IMPERSONATE,
    NULL, 
    EOAC_DYNAMIC_CLOAKING, 
    NULL);

if (FAILED(hr))
{
  CoUninitialize();
  cout << "Failed to initialize security. Error code = 0x"
       << hex << hr << endl;
  return;
}
```

分離プロバイダーレジストラーを登録します。

次のコード例に、分離プロバイダーレジストラーを登録する方法を示します。

CLSID CLSID_WbemDecoupledRegistrar;
IID IID_IWbemDecoupledRegistrar;
IWbemDecoupledRegistrar *myRegistrar = NULL;

hr = CoCreateInstance(CLSID_WbemDecoupledRegistrar,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_IWbemDecoupledRegistrar,
                      (void**)&myRegistrar);
if (SUCCEEDED(hr))
{
    IUnknown *pIUnknown = NULL;
    // CMyProv is the class added for WMI instance / event provider
    HRESULT hr = CMyProv::CreateInstance(NULL,&pIUnknown);
    if ( SUCCEEDED(hr))
    {
        hr = myRegistrar->Register(0,
            NULL,
            NULL,
            NULL,
            L"root\\cimv2",
            L"DecoupledInstanceProvider",
            pIUnknown);

            pIUnknown->Release();
    }
}

if (FAILED (hr))
{
    if ( myRegistrar )
    {
        myRegistrar->Release () ;
    }
}

分離イベントプロバイダーを登録します。

次のコード例に、分離イベントプロバイダーを登録する方法を示します。

IWbemDecoupledBasicEventProvider *myEvtRegistrar;

// -- Create an instance of IWbemDecoupledEventProvider
hr = CoCreateInstance(CLSID_WbemDecoupledBasicEventProvider,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_IWbemDecoupledBasicEventProvider,
                      (void**)&myEvtRegistrar);

if (SUCCEEDED(hr))
{
   // -- Register the DecoupledEventProvider
   hr = myEvtRegistrar->Register(0,
                                 NULL,
                                 NULL,
                                 L"root\\cimv2",
                                 L"DecoupledEventProvider",
                                 NULL, NULL);
   if (SUCCEEDED(hr))
   {
      IWbemServices *pService = NULL;
      hr = myEvtRegistrar->GetService (0, NULL, &pService);
      if (SUCCEEDED(hr))
      {
         IWbemObjectSink *pSink = NULL;
         hr = myEvtRegistrar->GetSink ( 0, NULL, &pSink );
         if (SUCCEEDED(hr))
         {
            // Provide events
         }
      }
   } 
}

プロバイダーの機能に必要な WMI の呼び出しを行います。詳細については、「クラスとインスタンスの情報の操作」を参照してください。プロバイダーがスクリプトまたはアプリケーションからのデータ要求を処理する場合の詳細については、「クライアントの偽装」を参照してください。

終了する直前に、アプリケーションはそれ自体のクリーンアップ処理を行う必要があります。以下の手順では、WMI が情報のクエリを実行しないように、分離プロバイダーの登録を解除する方法について説明します。

分離プロバイダーの登録を解除する方法を次の手順で説明します。

分離プロバイダーの登録を解除するには

レジストラーの登録を解除して解放します。

次のコード例は、レジストラーの登録を解除して解放する方法を示しています。
```
myRegistrar->UnRegister();
myRegistrar->Release();
```
イベントプロバイダーの登録を解除して解放します。

次のコード例は、イベントプロバイダーの登録を解除して解放する方法を示しています。
```
myEvtRegistrar->UnRegister();
myEvtRegistrar->Release();
```
COM サーバーをクリーンアップします。

COM ライブラリを初期化前の状態に戻す方法を次のコード例に示します。
```
CoUninitialize();
```

名前空間セキュリティ記述子の設定
プロバイダーのセキュリティ保護
WMI プロバイダーの開発

次の方法で共有

アプリケーションへのプロバイダーの組み込み

フィードバック

その他のリソース

次の方法で共有

アプリケーションへのプロバイダーの組み込み

関連トピック

フィードバック

その他のリソース