Intel(R) PRO
ネットワーク
アダプタ
WMI
および
CDM
プロバイダ
ユーザ ガイド
下記の情報は Dell 社による検証なしで、解説されたデバイスの出荷業者により提供され、下記の制限と免責条項 の条件が適用され
ます。
はじめに
WMI
主な機能
インストールされるファイル
セキュリティ
ネームスペースとコンテキスト
ロケールとローカライゼーション
エラーのレポート
コア スキーマ
イーサネット アダプタ スキーマ
設定スキーマ
チーム スキーマ
VLAN スキーマ
現在の設定の取得
設定の更新
イベントの通知
最適化された WQL クエリ
診断
IANet_DiagTest のメソッドの実行
CIM クラスの概要
ソフトウェア ライセンス
カスタマ サポート
本書は予告なく変更されることがあります。
(C) 2003 Intel Corporation.All rights reserved.
本書で使用されている商標：Dell および DELL のロゴは Dell Computer Corporation の商標です。Intel はインテル コーポレーション
またはインテルの子会社の米国およびその他の国における商標または登録商標です。
* 本書で使用している他社の商標および商品名は、その商標と商品名を主張するエンティティまたは他社の製品を参照していること
があります。インテル コーポレーションは、他社の商標および商品名において財産利益の責任を負いません。
制限 および免責条項
すべての説明、警告、規制の認証および保証を含む本書の情報は、出荷業者によって提供されており、Dell 社は証明または検証をし
ていません。Dell 社は説明書に従って実行、または従わずに実行したため発生した破損には、いずれにも一切責任を負いません。
本書に典拠された所有権、有効性、速度、または品質に関するすべての記述は、出荷業者によって作られたものであり、Dell 社のも
のではありません。Dell 社は、それらの記述の正確性、完全性、または実証性の知識を免責条項とします。陳述または請求に関する
質問またはコメントは、出荷業者に直接ご連絡ください。
初回リリース日：2003 年 10 月
目次に戻る
はじめに：Intel(R) PRO ネットワーク アダプタ WMI および CDM プロ
バイダ ユーザ ガイド
概要
Intel(R) PRO ネットワーク アダプタ WMI および CDM プロバイダ ユーザ ガイドへようこそ。本書では、Intel PRO ネットワーク
アダプタ WMI および CDM プロバイダの概要を説明します。Windows Management Interface (WMI) Provider は、Network
Configuration Services (NCS) のネットワーク設定ブロックです。NCS は、業界の標準的なメソッドを使用した、インテルのすべて
のエンドステーション ネットワーキング テクノロジーを導入および管理するための手段です。Intel PRO の Common Diagnostic
Model (CDM) Provider は、CIM 2.5 と WMI の標準に準拠した、上層インターフェイス API です。下層インターフェイスで
は、CDM Provider によって PROSet ソフトウェア スタックの下層レイヤにクライアント インターフェイスが実装されます。これ
により、すべての PROSet メカニズムでデータの整合性が保たれます。
WMI Provider と CDM Providerは、ソフトウェア コンポーネントのセットで、Intel WMI ネットワーク クラスを実装します。これら
のクラスは Desktop Management Task Force (DMTF) CIM Schema バージョン 2.5 に基づいています。
本書では、本製品に付属の Managed Object Format (MOF) ファイルに含まれる情報を繰り返すことはしません。たとえば、個々の
属性の詳細な意味については、MOF 属性の説明を参照してください。
本書では、Intel PROSet などの WMI アプリケーションが、どのようにクラスを使用してシステムのネットワークを設定するか、ま
た、どのようにクラスを使用して Intel ネットワーク インターフェイス カードをテストするかを説明します。本文書は、WMI API と
WMI SDK (http://www.microsoft.com/
（英語） から参照可能) に精通したユーザを対象に書かれています。
先頭に戻る
関連文書
WMI テクノロジをよりよく理解するには、次の文書を参照してください。
CIM スキーマ バージョン 2.0、2.2 (発行：Desktop Management Task Force (DMTF))。http://www.dmtf.org（英語）から参
照可能。
Microsoft Windows Management Interface (および、その他の管理に関する情
報)。http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmisdk/wmi/wmi_start_page.asp
（英語） から参照可
能。
Web-Based Enterprise Management (WBEM) イニシアチブ (発行：DMTF)。 http://www.dmtf.org/standards/wbem（英語）か
ら参照可能。
WMI (Microsoft CIM 実装) SDK。http://msdn.microsoft.com/downloads/（英語）から参照可能。
System Diagnostic Model White Paper (発行：DFTM)。 http://www.dmtf.org/standards/documents/CIM/DSP0138.pdf（英語）
から参照可能。
警告：本製品には、コンピュータ システムやネットワークを攻撃、または動作不能にするために使用できる情報が含まれていま
す。本製品を実装するには、Microsoft オペレーティング システムのセキュリティ機能について、十分に熟知していることが前
提条件となります。また開発者やユーザは、本製品の実働環境における実装を使用する前に、セキュリティに関する問題につい
て Microsoft 社に相談することを強く推奨します。
制限と免責条項
をすべてお読みください。
目次に戻る
先頭に戻る
2
目次に戻る
WMI：Intel(R) PRO ネットワーク アダプタ WMI および CDM プロバイ
ダ ユーザ ガイド
概要
Common Information Model (CIM スキーマ)
概要
WBEM (Web-Based Enterprise Management) は、企業のシステム マネージャに、標準化されたコスト効果の高いエンド ステー
ション管理の手段を提供するために設計された DMTF (Desktop Management Task Force (DMTF) のアプローチです。WBEM のア
プローチは、簡単なワークステーションの設定から、複数のプラットフォームにわたる大規模な企業管理まで、多数のタスクを含ん
でいます。このアプローチの中心となるのは、一般的な管理環境に存在するオブジェクトを表す拡張可能なデータ モデル CIM
(Common Information Model) と、モデル化されたデータの定義と保管のための言語 MOF (Managed Object Format) です。
WMI (Windows Management Instrumentation) は、Microsoft* Windows* プラットフォームのための WBEM の実装です。
WMI には次の 3 つの主なコンポーネントがあります。
Core - これらのコンポーネントはオペレーティング システムの一部です。これらは WMI 対応のアプリケーションが機能する
ために必要で、SDK を使用するためにはインストールされていることが必要です。
SDK - SDK には、WMI スキーマのブラウズ、スキーマの拡張、プロバイダの作成、WMI イベントの登録と使用のためのツー
ルが含まれています。また、WMI を使用するアプリケーションの開発に有用な文書も含まれています。SDK は Microsoft プ
ラットフォーム SDK のインストールの一環としてインストールされ、Windows NT4 SP4 または SP5、Windows
2000、Windows Me、Windows XP、および Windows Server 2003 でサポートされています。
Tools - Microsoft WMI Tools は、まったく新しい世代の管理アプリケーションとソリューションを作成するために必要なツー
ルを、開発者に提供します。Tools には、WMI から管理データにアクセスするプロセスをガイドする文書やツールが満載され
ています。
WMI アーキテクチャは次のコンポーネントで構成されています。
管理アプリケーション
管理されるオブジェクト
プロバイダ
管理インフラストラクチャ (Windows Management と Windows Management リポジトリで構成)
Windows Management API (COM/DCOM を使用して、プロバイダや管理アプリケーションが Windows 管理インフラストラ
クチャと通信できるようにする。)
管理アプリケーションでは、企業の論理的または物理的コンポーネントである、管理されるオブジェクトからのデータを処理、また
は表示します。これらのコンポーネントは CIM を使用して作成され、Windows Management を通じてアプリケーションからアクセ
スされます。プロバイダは Windows Management API を使用して、Windows Management に管理されるオブジェクトからのデータ
を供給し、アプリケーションからの要求を処理し、イベントの通知を生成します。
管理インフラストラクチャは Windows Management (管理アプリケーションとプロバイダ間の通信処理用) と Windows Management
リポジトリ (データの整理用) で構成されます。Windows Management リポジトリには、静的な管理データが保管されます。動的な
データは、プロバイダの要求に応じて生成されます。データは、MOF 言語コンパイラか、Windows Management API を使用して、
リポジトリに配置されます。
アプリケーションとプロバイダは、イベント通知やクエリー処理などのサービスを提供する Windows Management API を使用
し、Windows Management を通じて通信します。
次の図に、WMI アーキテクチャ コンポーネントの相関関係を示します。
3
先頭に戻る
Common Information Model (CIM スキーマ)
Common Information Model (CIM) は、管理される環境における、すべてのタイプの論理的および物理的オブジェクトを、一定の規
則にのっとって、一体化して表現します。管理されるオブジェクトは、クラスなどのオブジェクト指向の要素を使って表現されま
す。クラスには、データを記述するプロパティと、動作を記述するメソッドがあります。CIM は DMTF によって、オペレーティン
グ システムとプラットフォームに依存しないように設計されています。WBEM テクノロジには、Microsoft Windows オペレーティ
ング システム プラットフォームの拡張機能が含まれます。詳細については、DMTF Web サイトの DMTF CIM スキーマを参照して
ください。
CIM では、次の 3 つのレベルのクラスが定義されます。
管理のすべての領域に該当する、管理されるオブジェクトを表すクラス。これらのクラスでは、管理されるシステムを分析お
よび記述するための基本的な語彙が提供されます。これらのクラスはコア モデルと呼ばれるものの一部です。
特定の管理領域に該当するが、特定の実装やテクノロジには依存しない、管理されるオブジェクトを表すクラス。これらのク
ラスは、共通モデルと呼ばれるものの一部です。
共通モデルに対し、テクノロジに特有なものとして追加される、管理されるオブジェクトを表すクラス。これらのクラスは一
般的に特定のプラットフォーム (UNIX や Microsoft Win32 環境など) に該当し、拡張モデルと呼ばれます。
すべてのクラスは継承で関連付けることができます。継承では、子クラスが親クラスのデータとメソッドを含みます。継承による関
係は、一般的にこれらの関係を使用する管理アプリケーションで確認されることはなく、アプリケーションでも継承の階層を認識す
る必要はありません。クラスの階層は、WMI Tools に付属のアプリケーションを使用して取得できます。詳細について
は、http://www.microsoft.com の WMI Tools を参照してください。
Windows Management では、関連クラスもサポートされています。関連クラスは 2 つの異なるクラスをリンクしてユーザ定義の関
係を形成します。関連クラスは、管理アプリケーションで確認することができます。Windows Management では、関連クラスを定
義してシステムのクラスをサポートします。サードパーティの開発者も、独自の管理環境のための関連クラスを定義することができ
ます。
4
WBEM では、特定の管理環境で使用されるクラスやインスタンスをグループ化する、スキーマのコンセプトがサポートされていま
す。 プラットフォーム SDK には、 CIM スキーマおよび Microsoft Win32 スキーマの 2 つのスキーマが含まれます。CIM スキーマ
には、CIM の最初の 2 つのレベルのクラス定義が含まれています。これらのクラスは、プラットフォームにかかわらず、すべての管
理環境の一部である、管理されるオブジェクトを表します。Win32 スキーマには、一般的な Win32 環境の一部である、管理される
オブジェクトのクラス定義が含まれています。
CIM の詳細については、http://www.dmtf.org を参照してください。
制限と免責条項
をすべてお読みください。
目次に戻る
先頭に戻る
5
目次に戻る
主な機能：Intel(R) PRO ネットワーク アダプタ WMI および CDM プロ
バイダ ユーザ ガイド
NCS WMI Provider の機能
CDM Provider の機能
NCS WMI Provider の機能
WMI Provider の主な機能は次のとおりです。
アダプタに関する機能
Intel(R) PROSet でサポートされているすべての物理アダプタの列挙
インストールされているアダプタの設定の列挙
インストールされているアダプタの設定の追加、削除、更新
アダプタの物理デバイス情報の取得
アダプタのシステム スロット デバイス情報の取得
アダプタの IPv4 プロトコル設定の取得
アダプタの Boot Agent と関連する設定の更新と変更
アダプタのアンインストール
チームに関する機能
Intel PROSet でサポートされているチームの列挙
アダプタのチームの作成、削除
チームの設定の追加、削除、更新
チームのメンバー アダプタの追加、削除
チームの IPv4 プロトコル設定の取得
VLAN に関する機能
アダプタやチームの仮想 LAN の列挙
物理アダプタやアダプタのチームへの仮想 LAN の作成、削除
VLAN の設定の追加、削除、更新
チームの IPv4 プロトコル設定の取得
イベント通知機能
クライアントの登録を許可
アダプタ ステータス イベント
アダプタ設定イベント
セッション イベント
チーム ステータス イベント
チーム設定イベント
VLAN 設定イベント
先頭に戻る
CDM Provider の機能
CDM Provider の主な機能は次のとおりです。
診断テストのタイプに依存しない、テストの実行と停止、およびテスト結果のクリア
汎用設定クラスの使用により、CDM ソフトウェアでは予期されないテストの制御を可能にする
6
目次に戻る
インストールされるファイル：Intel(R) PRO ネットワーク アダプタ
WMI および CDM プロバイダ ユーザ ガイド
WMI ファイル
CDM Provider ファイル
WMI ファイル
実行可能ファイル
WMI Provider の実行可能ファイルは、次のとおりです。
NcsWmiCo.exe - コア プロバイダ。IANet_NetService とコア イベント クラスを実装します。
NcsWmiIm.exe - インスタンスとメソッドのプロバイダ。イーサネット アダプタ スキーマ、チーム化スキーマ、設定スキー
マ、VLAN スキーマを実装します。
NcsWmiEv.exe - イベント プロバイダ。アダプタ、チーム、VLAN のイベントを実装します。
MOF ファイル
言語に依存しないデータと、言語に特有なデータに対し、別々の MOF ファイルがあります。また、IntelNCS と CIMV2 ネームス
ペースに対し、別々の MOF ファイルがあります。詳細については、
ロケールとローカライゼーションおよび エラーのレポートを参
照してください。
IntelNCS ネームスペースの MOF ファイルは次のとおりです。
NcsCmLn.mof - NCS クラスが依存する CIM の基本クラス。
NcsCmEnu.mfl - CIM 基本クラスのアメリカ英語版。
NcsCoLn.mof - コア プロバイダで実装されるコア クラス。
NcsCoEnu.mfl - コア クラスのアメリカ英語によるテキスト修正。
NcsIaLn.mof - IEEE 802.3 アダプタ、チーム、VLAN のクラス。
NcsIaEnu.mfl - 802.3 コア クラスのアメリカ英語によるテキスト修正。
CIMV2 ネームスペースの MOF ファイルは次のとおりです。
C2CmLn.mof - NCS クラスが依存する CIM の基本クラス。
C2CmEnu.mfl - CIM 基本クラスのアメリカ英語版。
C2CoLn.mof - コア プロバイダで実装されるコア クラス。
C2CoEnu.mfl - コア クラスのアメリカ英語によるテキスト修正。
C2IaLn.mof - IEEE 802.3 アダプタ、チーム、VLAN のクラス。
C2IaEnu.mfl - 802.3 コア クラスのアメリカ英語によるテキスト修正。
リソース ファイル
WMI Provider のリソース ファイルは次のとおりです。
ENU_8023.dll - 英語 USA 8023 リソース。
ENU_NWRC.dll - コア プロバイダの英語 USA WMI リソース。
ENU_NWR.dll - 8023 プロバイダの英語 USA WMI リソース。
その他のローカライズされたリソース ファイルも、オンデマンドでロードできます。ローカライズされたリソース DLL の名前の一
般的なパターンは「_mwr.dll」で、これがローカライゼーションの言語コードです。たとえば、標準フランス語は FRA です。
先頭に戻る
8
CDM Provider ファイル
実行可能ファイル
CDM Provider の実行可能ファイルは、次のとおりです。
Ncsdiag.exe CDM 診断の主な実行可能ファイル。Microsoft* WMI インターフェイス仕様に準拠し、プロセス外の COM サー
バとしてアクセスされます。
Intel(R) PROSet ソフトウェア スタックのその他の実行可能ファイル
MOF ファイル
マスタ .mof ファイルは製品には付属していませんが、Microsoft* Windows* Management Instrumentation グローバル化モデルに基
づいて、対応する言語に依存するコンポーネントや依存しないコンポーネントにコンパイルされています。詳細について
は、Microsoft* WMI SDK (プラットフォーム SDK のコンポーネント) の WMI ローカライゼーションの章を参照してください。特
に、「Compiling Localized MOF Files (ローカライズされた MOF ファイルのコンパイル)」の項を注意して読んでください。
.mof ファイル (DNcsCdmN.mof) を削除すると、Intel から派生したクラス定義は削除されますが、DMTF で定義されたクラスは、削
除してしまうとほかの既存のアプリケーションに障害が出る恐れがあるため、削除されません。
この CDM 実装は、典型的に CIMV2 ネームスペースに基づいて使用されます。IntelNCS ネームスペースの MOF ファイルは次のと
おりです。
ファイル名 言語タイプ 説明
CdIa.mof マスタ Intel CDM 実装のクラス定義
CdIaLn.mof 言語に依存しない Intel CDM 実装のクラス定義
CdIaEnu.mfl 英語に依存 Intel CDM 実装の言語拡張
CdCm.mof マスタ コア スーパーセット CDM クラスの定義
CdCmLn.mof 言語に依存しない コア スーパーセット CDM クラスの定義
CdCmEnu.mfl 英語に依存 コア スーパーセット CDM クラス定義の言語拡張
DNcsCdmN.mof 該当せず Intel CDM クラスを削除
CIMV2 ネームスペースの MOF ファイルは次のとおりです。
ファイル名 言語タイプ 説明
C2Icd.mof マスタ Intel CDM
実装のクラス定義
C2IcdLn.mof 言語に依存しない Intel CDM 実装のクラス定義
C2IcdEnu.mfl 英語に依存 Intel CDM 実装の言語拡張
C2Cd.mof マスタ コア スーパーセット CDM クラスの定義
C2CdLn.mof 言語に依存しない コア スーパーセット CDM クラスの定義
C2CdEnu.mfl 英語に依存 コア スーパーセット CDM クラス定義の言語拡張
DNcsCdm2.mof 該当せず Intel CDM クラスを削除
9
目次に戻る
ネームスペースとコンテキスト：Intel(R) PRO ネットワーク アダプタ
WMI および CDM プロバイダ ユーザ ガイド
CIM クラスはネームスペース内に常駐します。Microsoft* の標準ネームスペースは root/cimv2 と呼ばれ、CIM v2.2 または
root/default に基づいています。WMI Provider と CDM Provider のクラスは、このネームスペースに追加できます。これらのプロバ
イダは CIM v2.5 に基づいています。このため、また、オブジェクトのキーの相違のため、両者のクラスは別のネームスペー
ス、root/IntelNCS にあります。
WBEM コンテキスト
コンテキスト オブジェクトでは、WMI API メソッドにパラメータとして渡すことのできない追加情報が、Provider に提供されま
す。コンテキスト修飾子を登録するには、IWbemContext を使用します。コンテキスト オブジェクトのインターフェイス ポインタ
は、IWbemServices メソッドの最後のパラメータとして渡されます。
次の表に、Provider で使用されるコンテキスト修飾子 (指定された値) をあげます。SessionHandle などのほとんどの修飾子
は、Provider の特定の領域の機能とともにのみ使用されますが、LocaleID、MachineName、ApplicationName は、すべての
IWbemServices 呼び出しに設定できます。
Provider にコンテキストが渡されない場合は、Provider への Initialize 呼び出しで渡された LocaleID が使用されます。コンテキスト
を使用して行われるすべての読み取りでは、書き込みが実行されるまで、現在の設定が読み取られます。書き込み後の読み取りで
は、書き込みが成功した後のシステムの状態が表示されます。読み取りには、NULL コンテキストを使用することができます。
コンテキスト修飾
子
バリアン
トのタイ
プ
説明
SessionHandle VT_BSTR アプリケーションの IANet
ネットワーク クラスを識別します。アプリケーションは、まずセッ
ション ハンドルを確立しない限り、クラスやクラスの属性に変更を加えることはできません。
セッション ハンドルの確立と使用については、IANet_NetService クラスの項を参照してくださ
い。この修飾子は、アプリケーションでクラスからデータを読み取るだけの場合は必要ありませ
ん。セッション ハンドルにより、NCS ソフトウェアが設定への複数の同時アクセスを管理でき
るようになり、1 人のユーザがほかのユーザをロックアウトしなくてもすむようになります。各
セッションには変更された内容を保存するために、それぞれ別のキャッシュがあります。複数の
ユーザが同時に変更を行っている場合は、最初に変更を適用したユーザの変更が有効になりま
す。その他のすべてのユーザのキャッシュは無効になります。
LocaleID VT_BSTR Microsoft のロケールの ID。これは、アプリケーションが Provider からローカライズされたテキ
スト文字列を必要とする場合に必要です。必須の LocalID が使用されない限り、すべてのエラー
メッセージと警告は英語で表示されます。
ApplicationName VT_BSTR 呼び出しを行ったアプリケーションの名前。これはログ記録に必要です。
MachineName VT_BSTR Provider に接続中のマシンの名前。これはログ記録に必要です。
PreCheck VT_BOOL このブール値は、クライアントが実際に操作を行う前に、操作が許可されているかどうかを確認
しようとしていることを、Provider に告げるために使用されます。たとえば、チームへのアダプ
タの追加などです。
値：
TRUE = 操作が許可されていない場合、Provider は操作を実行せず、エラー コードと詳
細なステータスを返します。
FALSE = Provider は操作を実行します。
この修飾子がない場合は、属性が FALSE と同じ効果をもちます。
12
目次に戻る
ロケールとローカライゼーション：Intel(R) PRO ネットワーク アダプ
タ WMI および CDM プロバイダ ユーザ ガイド
ローカライズされた MOF ファイル
ローカライズされた属性データ
WMI Provider と CDM Provider のローカライゼーションには、2 つ要素があります。ローカライズされた MOF ファイルと、ローカ
ライズされた属性データです。
ローカライズされた MOF ファイル
Provider で使用されるすべての MOF ファイルは、Microsoft Windows* Management Instrumentation (WMI) グローバル化モデルに
基づいて、ローカライズされます。このために、各クラス定義は次のように分類されます。
.mof ファイル：基本的なクラスの定義のみを含む、言語に依存しないバージョン。
対応する .mfl ファイル：ローカライズされた情報を含む、特定の言語のためのバージョン。ロケールに特有のプロパティの
説明などです。
サポートされている言語
中国語 (台湾)
中国語 (中華人民共和国)
デンマーク語
オランダ語 (オランダ)
英語 (アメリカ合衆国)
フィンランド語
フランス語 (フランス)
ドイツ語 (ドイツ)
イタリア語 (イタリア)
日本語
ノルウェー語 (ブークモール)
ポルトガル語 (ブラジル)
スペイン語 (スペイン - 近代)
スウェーデン語
クラスの保管
言語に特定のクラス定義は、言語に依存しない基本クラス定義を含むネームスペースの下の、子サブネームスペースに保管されま
す。たとえば、WMI Provider と CDM Provider では、英語のロケールのために、子ネームスペース ms_409 が root/Intelncs ネーム
スペースの下に存在します。同様に、root/Intelncs ネームスペースの下に、サポートされている各言語の子サブネームスペースがあ
ります。
CIMV2 ネームスペースにおけるローカライズされた MOF のサポート
root/cimv2 ネームスペースでは、Provider のクラス (IANet_ classes) は WMI でこのネームスペースに追加された基本クラスから派
生します。基本クラスの言語に特有なクラス定義を含むサブネームスペースは、root/cimv2 ネームスペースの下にあらかじめ存在し
ます。この既存の子ネームスペースに、IA_Net の言語に特定のクラス定義が追加されます。この基本クラスへの依存性のた
め、MOF のローカライズは、デフォルトのシステム ロケールでのみ行われます。
ランタイムのサポート
14
ローカライズされたデータを取得するために、
WMI
アプリケーションでは
SWbemLocator::ConnectServer
と
IWbemLocator::ConnectServer の呼び出しで、strLocale パラメータを使用してロケールを指定できます。ロケールが指定されない
場合は、システムのデフォルトのロケールが使用されます。(たとえば、アメリカ英語では MS_409。)このロケールは、英語の文字
列に追加する際に、適切なネームスペースを選択するのに使用されます。
さらに、IWbemServices::GetObject、SwbemServices.GetObject、IWbemServices:: ExecQuery、および
SWbemServices.ExecQuery は、WBEM_FLAG_USE_AMENDED_QUALIFIERS フラッグを指定して、ローカライズされたデータ
および基本的な定義を要求する必要があります。これは、値のマップ、表示の記述、またはその他の MOF ファイルからの修正修飾
子を使用する、表示可能な値を生成するすべての機能で必須です。
先頭に戻る
ローカライズされた属性データ
エラー メッセージなどの、ローカライズされた属性データを取得するために、Provider はすべての呼び出しに対して、呼び出し機の
ロケールを知ることが必要です。これが適切に機能するためには、クライアントがすべての呼び出しに渡されるコンテキスト オブ
ジェクトにロケールを追加することが必要です (WBEM コンテキストのネームスペースとコンテキスト
を参照)。Provider がローカ
ライズ可能な文字列を返す場合、クライアントのロケールに対応したリソース DLL のロードが試みられます。対応するリソース
DLL がない場合は、アメリカ英語の文字列が返されます。
制限と免責条項
をすべてお読みください。
目次に戻る
先頭に戻る
15
目次に戻る
エラーのレポート：Intel(R) PRO ネットワーク アダプタ WMI および
CDM プロバイダ ユーザ ガイド
概要
エラー コード
概要
この項では、IANet_ExtendedStatus に関し、WMI Provider や CDM Provider で生成されるエラーの処理方法について説明します。
エラー オブジェクトが返される方法や状況は、呼び出しが同時性、半同時性、非同時性のいずれかによって異なります。場合によっ
ては、エラーが発生すると HRESULT が WBEM_E_FAILED に設定されます。ただし、この時点ではエラーを生成したのが WMI か
Provider かは不明です。
同時性呼び出しのエラー オブジェクトを取得するには、GetErrorInfo() を使用して IErrorInfo object を取得します。QueryInterface()
を使用して、エラー情報を含む IWbemClassObject を取得します。
非同時性呼び出しのエラー オブジェクトを取得するには、IWbemClassObject を最後の SetStatus() 呼び出しの最後のアイテムとし
て渡します。エラー オブジェクトのインスタンスを取得したら、__Class プロパティをチェックして、エラーの原因を判定しま
す。IANet_ クラスに関連するエラーでは、WMI で __ExtendedStatus のインスタンスが、Provider で IANet_ExtendedStatus のイン
スタンスが作成されます。IANet_ExtendedStatus は __ExtendedStatus から派生し、次のエラー オブジェクト修飾子を含みます。
Description - 現在のロケールにあわせたエラーの説明
File - エラーが発生したコード ファイル
Line - コード ファイル内でエラーのある行の番号
ParameterInfo - エラーが発生した時点で使用されていたクラスまたは属性
Operation - エラーが発生した際に処理中だった操作
ProviderName - エラーを引き起こした Provider の名前
StatusCode - 失敗した内部呼び出しから返されたコード
SessionHandle - 処理に使用されたセッション ハンドル
RuleFailureReasons - 処理が失敗した理由処理は、技術的な規則が失敗したために、失敗することがあります。たとえば、
チームによっては、管理アダプタが必要な場合があります。
先頭に戻る
エラー コード
すべてのエラー コードに対し、Provider からロケールに合わせてカスタマイズされた説明が提供されます。エラー コードは
HRESULT の形式で、重要度 1、機能が ITF に設定された状態になります。アプリケーションでは、次のコードに基づいて普及を行
うことができます。
0x80040901 - "WMI: Put property failed"
0x80040902 - "WMI: No class object"
0x80040903 - "WMI: Failed to create class"
0x80040904 - "WMI: Failed to spawn instance of class"
0x80040905 - "WMI: Failed to create safe array"
0x80040906 - "WMI: Failed to put safe array"
0x80040907 - "WMI: Failed to return object to WMI"
0x80040908 - "WMI: Get property failed"
0x80040909 - "WMI: Unexpected type while getting property"
0x8004090A - "WMI: Class not implemented by this provider"
0x8004090B - "WMI: Unable to parse WQL statement"
0x8004090C - "WMI: Providers only support WQL"
0x8004090D - "WMI:0x8004090D - "WMI: Parameter in context has the wrong type"
16
0x8004090E - "WMI: Error formatting debug log"
0x8004090F - "WMI: bad object path"
0x80040910 - "WMI: Failed to update setting"
0x80040911 - "WMI: Null parameter passed to method"
0x80040912 - "Setting value too small."
0x80040913 - "Setting value too big."
0x80040914 - "Setting not in step"
0x80040915 - "String setting is too long"
0x80040916 - "Setting is not one of the allowed values"
0x80040917 - "WMI: Qualifier not found"
0x80040918 - "WMI: Qualifer set not found"
0x80040919 - "WMI: Safe array access failed"
0x8004091A - "WMI: Unhandled exception"
0x8004091B - "WMI:0x8004091B - "WMI: Operation is not supported for this class"
0x8004091C -"WMI: Unexpected event class"
0x8004091D -"WMI: Bad event data"
0x8004091E -"WMI: Operation succeeded with warnings"
0x8004081F -"WMI:0x8004081F - "WMI: The NCS Service has been stopped."
0x80040801 -"EAL: Internal exception"
0x80040802 -"EAL: General failure"
0x80040803 -"EAL: Not initialized"
0x80040804 -"EAL: Failed to initialize."
0x80040805 -"EAL: Session limits exceeded"
0x80040806 -"EAL: Out of memory"
0x80040807 -"EAL: Rule syntax error"
0x80040808 -"EAL: Unexpected end of list"
0x80040809 -"EAL: Rule link error"
0x8004080A -"EAL: Device Creation Failed"
0x8004080B -"EAL: Media service not found"
0x8004080C -"EAL: Device service not found"
0x8004080D -"EAL: PCI bus module not found"
0x8004080E - "EAL: Adapter is a member of a team"
0x8004080F -"EAL: Rule Access Point creation error"
0x80040810 -"EAL: Registry key error"
0x80040811 - "EAL: Registry XML file path error"
0x80040812 - "EAL: Unknown event class"
0x80040813 - "EAL: Unknown module id"
0x80040814 - "EAL: Rule service not found"
0x80040815 - "EAL: NULL input pointer"
0x80040816 - "EAL: Rule grammar error"
0x80040817 - "EAL: Rule failed"
0x80040818 - "EAL: Setting is already grouped"
0x80040220 - "Sync Layer: Team removal failed."
0x80040221 - "Sync Layer: Vlan creation failed."
0x80040222 - "Sync Layer: Vlan removal failed."
0x80040223 - "Sync Layer: Adapter removal failed."
0x80040224 - "Sync Layer: Setting Change/Creation/Removal failed."
0x80040225 - "Sync Layer: Parameter Change/Removal failed."
0x80040226 - "Sync Layer: NetConfig subsystem locked. "
0x80040227 - "Sync Layer: System Update In Progress. Please try again later."
0x80040228 - "Sync Layer: Adapter is Locked"
0x80040229 - "Sync Layer: Flash read failed."
0x8004022A - "Sync Layer:"
0x80040210 - "Sync Layer: Invalid event offset"
0x80040211 - "Sync Layer: Invalid input"
0x80040212 - "Sync Layer: Invalid key"
0x80040213 - "Sync Layer: Adapter not team member"
17
0x80040214 - "Sync Layer: Driver not loaded"
0x80040215 - "Sync Layer: Client impersonation failed"
0x80040216 - "Sync Layer: Caught exception"
0x80040217 - "Sync Layer: Session not locked"
0x80040218 - "Sync Layer: Hardware access layer is not available"
0x80040219 - "Sync Layer: Flash not available"
0x8004021A - "Sync Layer: Diagnostics not supported"
0x8004021B - "Sync Layer: Diagnostic test not running"
0x8004021C - "Sync Layer: Boot Agent update not available"
0x8004021D - "Sync Layer: Boot Agent corrupted."
0x8004021E - "Sync Layer: Flash write failed."
0x8004021F - "Sync Layer: Team creation failed."
0x80040201 - "Sync Layer: Initialization failed"
0x80040202 - "Sync Layer: Invalid initialization handle"
0x80040203 - "Sync Layer: Session handle already exists"
0x80040204 - "Sync Layer: Invalid session handle"
0x80040205 - "Sync Layer: The maximum number of sessions has been reached."
0x80040206 - "Sync Layer: The session lock handle already exists"
0x80040207 - "Sync Layer: Invalid session lock handle"
0x80040208 - "Sync Layer: Session already locked"
0x80040209 - "Sync Layer: Invalid media service module Id"
0x8004020A - "Sync Layer: Invalid Advanced Service Module Id"
0x8004020B - "Sync Layer: Invalid device service module Id"
0x8004020C - "Sync Layer: Invalid component type Id"
0x8004020D - "Sync Layer: Invalid bus interface module Id"
0x8004020E - "Sync Layer: Invalid sink window handle"
0x8004020F - "Sync Layer: Invalid event Id"
0x80040401 - "HAM PCI: Invalid memory map address"
0x80040402 - "HAM PCI: Configuration driver failed to load"
0x80040403 - "HAM PCI: Configuration driver version mismatch"
0x80040404 - "HAM PCI: Device slot not found"
0x80040405 - "HAM PCI: Diagnostic driver failed to load"
0x80040406 - "HAM PCI: Diagnostic driver version mismatch"
0x80040407 - "HAM PCI: Diagnostic driver initialization failed"
0x80040408 - "HAM PCI: Diagnostics not initialized"
0x80040409 - "HAM PCI: Diagnostics already initialized"
0x8004040A - "HAM PCI: Diagnostic test already running"
0x8004040B - "HAM PCI: Diagnostic test not running"
0x8004040C - "HAM PCI: Diagnostic test terminated"
0x8004040D - "HAM PCI: Diagnostic Invalid test number"
0x8004040E - "HAM PCI: Diagnostic hardware missing"
0x8004040F - "HAM PCI: Diagnostic send receive initialization failed"
0x80040511 - "Media Service: NDIS IO call failed"
0x80040512 - "Media Service: Miniport not loaded"
0x8004051B - "Media Service: Invalid device handle"
0x8004051C - "Media Service: Invalid adapter handle"
0x8004051D - "Media Service: Invalid team handle"
0x8004051E - "Media Service: Invalid VLAN handle"
0x8004051F - "Media Service: Device missing"
0x80040520 - "Media Service: Invalid setting type"
0x80040521 - "Media Service: Unknown invalid object"
0x80040522 - "Media Service: Invalid Setting Handle"
0x80040523 - "Media Service: Invalid Team Mode"
0x80040525 - "Media Service: Setting Already Exists"
0x80042001 - "RAP: Already initialized"
0x80042002 - "RAP: Invalid XML file"
0x80042003 - "RAP: XML load error"
18
0x80042004 - "RAP: Not initialized"
0x80042005 - "RAP: Rule not extracted before"
0x80042006 - "RAP: Conditions count mismatch"
0x80042007 - "RAP: Results apply error"
0x80042008 - "RAP: Invalid rule"
0x80042009 - "RAP: Node not found"
0x8004200A - "RAP: Error no single node"
0x8004200B - "RAP: No action rule"
0x8004200C - "RAP: Zero condition"
0x8004200D - "RAP: Zero action"
0x8004200E - "RAP: XML Decode error"
制限と免責条項
をすべてお読みください。
目次に戻る
先頭に戻る
19
目次に戻る
コア スキーマ：Intel(R) PRO ネットワーク アダプタ WMI および CDM
プロバイダ ユーザ ガイド
概要
IANet_NetService
コア イベント
使用例
概要
コア スキーマは、IANet_NetService クラスとコア イベント クラスで構成されます。
先頭に戻る
IANet_NetService
用途
IANet_NetService クラスは、IANet_ schema のルート オブジェクトです。このクラスにより、クライアントがセットを実行するの
に必要なセッションにアクセスできるようになります。
インスタンス
このオブジェクトのインスタンスは 1 つです。クライアントでは、このクラスに使用されているキーに依存しないようにします。代
わりに、IANet_NetService のすべてのインスタンスを列挙して、クラスのインスタンスを取得します。
インスタンスの作成
IANet_NetService のインスタンスを作成することはできません。
インスタンスの削除
20
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
ページを読み込んでいます...
/