目次に戻る

ネームスペースとコンテキスト: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 と同じ効果をもちます。

WarningErrorCode VT_I4 一部の操作では、ユーザに警告を送信する必要の生じることがあります。たとえば、チームへアダプタを追加する際に、場合によってはチームを再ロードしなければならないことがあります。WMI では、このためのメカニズムは提供されていません。この修飾子が存在し、設定がゼロでない場合、操作が完了し、関連する警告がある際には、Provider から E_FAIL が返されます。クライアントで詳細ステータスを使って、警告のテキストを取得します。


制限と免責条項をすべてお読みください。


目次に戻る 先頭に戻る