WMI 用 COM API
WMI コンポーネント オブジェクト モデル (COM) API を使用して、管理クライアント アプリケーションを作成したり、新しい "WMI プロバイダー" を作成したりすることができます。 COM API リファレンスでは、上級システム管理者と、クライアント アプリケーションやプロバイダー アプリケーションを作成している開発者向けの情報が提供されています。
WMI エンタープライズ管理アプリケーションの作成の詳細については、「C++ を使用した WMI アプリケーションの作成」を参照してください。 WMI プロバイダーを作成する方法の詳細については、「WMI へのデータの提供」を参照してください。
注意
WMI でサポートされるのは、Microsoft Visual C++ バージョン 6.0 以降の開発システムを使用する C++ 開発のみです。 ただし、Borland や Watcom のコンパイラなど、他のコンパイラも使用できます。
さまざまな WMI オブジェクトはそれぞれ、結局 IUnknown インターフェイスから継承されたインターフェイスから継承されます。 COM では、オブジェクトを実装するもの (インターフェイス) により、メモリ管理、パラメーター管理、マルチスレッド処理などのタスクがどのように処理されるかが指定されます。 WMI 用 COM API では、COM に準拠することで、各 WMI オブジェクトのインターフェイスによって提供される機能が確実にサポートされます。
WMI へのアクセスは、以下に示す WMI 固有の COM インターフェイスを介して行われます。
| インターフェイス | 説明 |
|---|---|
| IEnumWbemClassObject | IWbemClassObject 型のオブジェクトを操作する列挙子。 これは、IEnumVariant などの標準的な COM 列挙子に似ています。 |
| IMofCompiler | Mofd.dll によって実装されているこのインターフェイスでは、MOF コンパイラや、MOF ファイルをコンパイルするその他のアプリケーションで使用される COM インターフェイスを提供します。 |
| IUnsecuredApartment | クライアント プロセスから非同期呼び出しを行うプロセスを簡略化するために使用されます。 |
| IWbemBackupRestore | WMI リポジトリの内容のバックアップと復元を行います。 |
| IWbemCallResult | IWbemServices インターフェイスの半同期呼び出しに使用されます。 このような呼び出しを行うと、IWbemCallResult オブジェクトと共に、呼び出された IWbemServices メソッドが直ちに返ります。 |
| IWbemCausalityAnalysis | 親要求から生成される子要求を追跡します。 |
| IWbemClassObject | クラス定義とクラス オブジェクト インスタンスの両方を格納して操作します。 開発者は、このインターフェイスを実装する必要はありません。その実装は WMI によって提供されます。 |
| IWbemConfigureRefresher | リフレッシャーに、列挙子、オブジェクト、入れ子になったリフレッシャーを追加または削除するために、クライアント コードによって使用されます。 |
| IWbemContext | IWbemServices 呼び出しを Windows Management に送信するときに、追加のコンテキスト情報をプロバイダーに通信するために必要に応じて使用されます。 |
| IWbemDecoupledBasicEventProvider | 分離プロバイダーを WMI に登録します。 |
| IWbemDecoupledRegistrar | 分離プロバイダーを WMI に関連付けます。 このインターフェイスを使用すると、プロセスでホストされるプロバイダーでインターフェイスの相互運用性の有効期間を定義し、他のプロバイダーと共存できます。 |
| IWbemEventConsumerProvider | イベント コンシューマー プロバイダーのプライマリ インターフェイスを提供します。 イベント コンシューマー プロバイダーでは、このインターフェイスと FindConsumer メソッドにより、特定のイベントを受信する必要があるイベント コンシューマーを指定できます。 |
| IWbemEventProvider | イベント プロバイダーとの通信を開始するために使用されます。 |
| IWbemEventProviderQuerySink | どの種類のイベント クエリ フィルターが現在アクティブになっているかを特定してパフォーマンスを最適化するため、イベント プロバイダーによって必要に応じて実装されます。 |
| IWbemEventProviderSecurity | イベントに対するコンシューマー アクセスを制限するため、イベント プロバイダーによって必要に応じて実装されます。 |
| IWbemEventSink | 制限付きのクエリ セットを使用して、イベント プロバイダーとの通信を開始します。 このインターフェイスは、IWbemObjectSink を拡張して、セキュリティとパフォーマンスを扱う新しいメソッドを提供するものです。 |
| IWbemHiPerfProvider | プロバイダーが、更新可能なオブジェクトと列挙子を提供できるようにします。 |
| IWbemHiPerfEnum | インスタンス オブジェクトの列挙への迅速なアクセスを提供するため、リフレッシャーの操作で使用されます。 |
| IWbemLocator | 特定のホスト コンピューター上の WMI のために、IWbemServices インターフェイスへの初期名前空間ポインターを取得します。 |
| IWbemObjectAccess | オブジェクトのメソッドとプロパティへのアクセスを提供します。 IWbemObjectAccess オブジェクトは、"リフレッシャー" によって更新されたインスタンスのコンテナーです。 |
| IWbemObjectSink | IWbemServices の結果と、特定の種類のイベント通知の両方を受信するために使用されます。 |
| IWbemObjectTextSrc | IWbemClassObject インスタンスと、異なるテキスト形式との間の変換のために使用されます。 |
| IWbemPropertyProvider | WMI クラスのインスタンスに含まれる個々のプロパティの取得と更新をサポートします。 |
| IWbemProviderIdentity | プロバイダーが、同じ CLSID 値を持つ複数の名前 (__Win32Provider の複数のインスタンス) を使用して自身を登録する場合に、イベント プロバイダーによって実装されます。 このクラスには、どの名前付きプロバイダーを使用する必要があるかを区別するためのメカニズムが用意されています。 |
| IWbemProviderInit | プロバイダーを初期化するために使用されます。 |
| IWbemProviderInitSink | WMI によって実装されて、初期化の状態を報告するためにプロバイダーによって呼び出されます。 |
| IWbemQualifierSet | 1 つのプロパティまたはオブジェクト全体 (クラスまたはインスタンス) の名前付き修飾子のセット全体のコンテナーとして機能します。 |
| IWbemQuery | "WMI クエリ言語" (WQL) のクエリを解析できるエントリ ポイントを提供します。 |
| IWbemRefresher | 列挙子やリフレッシャー オブジェクトなどの更新可能なオブジェクトを更新できるエントリ ポイントを提供します。 |
| IWbemServices | WMI サービスにアクセスするためにクライアントとプロバイダーによって使用されます。 インターフェイスは、WMI によってのみ実装される、プライマリ WMI インターフェイスです。 |
| IWbemStatusCodeText | エラー コードのテキスト文字列の説明、またはエラーが発生したサブシステムの名前を抽出します。 |
| IWbemUnboundObjectSink | すべての論理イベント コンシューマーによって実装されます。 これは、イベント オブジェクトの配信を受け入れる単純なシンク インターフェイスです。 |
注意
WMI COM 関数の多くは、名前付き定数として文書化されている数値のエラー コードを返します。 これらの定数は、PSDK の WMI\Include フォルダーの Wbemcli.h で定義されています。 詳細については、「WMI リターン コード」を参照してください。
COM プログラミングに関する以下のトピックの詳細については、「コンポーネント開発」を参照してください。
- インターフェイスとオブジェクトの設計。
- IUnknown の実装。
- メモリ管理
- 参照カウントの処理。
関連トピック