Dell Intel PRO Family of Adapters ユーザーガイド

Intel(R) PRO

ネットワーク

アダプタ

WMI

および

CDM

プロバイダ

ユーザガイド

下記の情報は Dell 社による検証なしで、解説されたデバイスの出荷業者により提供され、下記の制限と免責条項の条件が適用され

ます。

はじめに

WMI

主な機能

インストールされるファイル

セキュリティ

ネームスペースとコンテキスト

ロケールとローカライゼーション

エラーのレポート

コアスキーマ

イーサネットアダプタスキーマ

設定スキーマ

チームスキーマ

VLAN スキーマ

現在の設定の取得

設定の更新

イベントの通知

最適化された WQL クエリ

診断

IANet_DiagTest のメソッドの実行

CIM クラスの概要

ソフトウェアライセンス

カスタマサポート

本書は予告なく変更されることがあります。

本書で使用されている商標：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

CDM Provider

はアダプタのみに使用

汎用結果クラスの使用により、特定の結果メッセージを CDM Provider のコードから解放

レジストリエントリによって Provider の実行を制御

テスト結果を結果ログファイルに書き込み

制限と免責条項

をすべてお読みください。

目次に戻る

先頭に戻る

7

目次に戻る

インストールされるファイル：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

注：

ローカライゼーションでは、適切な言語に依存する

.mof

ファイルを追加する必要があります。

リソースファイル

CDM Provider のリソースファイルは次のとおりです。

ENU_Diag.dll - Diagnostic Provider の英語 USA WMI リソース。

制限と免責条項

をすべてお読みください。

目次に戻る

先頭に戻る

10

目次に戻る

セキュリティ：Intel(R) PRO ネットワークアダプタ WMI および CDM

プロバイダユーザガイド

WMI Provider と CDM Provider は、クライアントを擬人化してセキュリティを管理します。Provider へのすべての呼び出しは、ク

ライアント自身のセキュリティコンテキストで作成され、このコンテキストは下層レイヤへと渡されます。ターゲットマシンに管

理権限がない場合、 1 つまたはすべての操作が失敗することがあります。

制限と免責条項

をすべてお読みください。

目次に戻る

先頭に戻る

11

目次に戻る

ネームスペースとコンテキスト：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

WarningErrorCode VT_I4 一部の操作では、ユーザに警告を送信する必要の生じることがあります。たとえば、チームへア

ダプタを追加する際に、場合によってはチームを再ロードしなければならないことがありま

す。WMI では、このためのメカニズムは提供されていません。この修飾子が存在し、設定がゼロ

でない場合、操作が完了し、関連する警告がある際には、Provider から E_FAIL が返されます。

クライアントで詳細ステータスを使って、警告のテキストを取得します。

制限と免責条項

をすべてお読みください。

目次に戻る

先頭に戻る

13

目次に戻る

ロケールとローカライゼーション：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

ページが読み込まれています...

Dell Intel PRO Family of Adapters ユーザーガイド

Dell Intel PRO Family of Adapters ユーザーガイド

関連論文

その他のドキュメント