概要
アダプタ、チーム、または VLAN 設定の変更
新しい空のチームの作成
アダプタのチームへの追加
アダプタのチームからの削除
チームの削除
チームのモードの変更
アダプタのチーム内の優先度の変更
アダプタのアンインストール
VLAN の作成
VLAN の属性の変更
VLAN の削除
Boot Agent の更新
ほとんどの場合、設定を更新するには、クライアント アプリケーションが IANet_NetService クラスからセッション ハンドルを入手し、このハンドルを IWbemContext コンテキスト オブジェクトに保存する必要があります。設定は IANet_NetService に Apply メソッドが呼び出された場合にのみ変更されます。ただし、これにはいくつかの例外があります。
一部の処理では、コンテキストに PreCheck 修飾子を使用して、処理が許可されているかどうかを確認することができます。これにより、必要に応じてユーザ インターフェイスで特定のコントロールやメニュー アイテムを無効にできます。
アダプタ、チーム、または VLAN 設定を変更するには:
アダプタ、VLAN、またはチームの設定を変更するには、クライアントが変更する設定のオブジェクト パスをあらかじめ取得しておくことが必要です。このためには、オブジェクトの設定を列挙して、設定の __PATH 属性を保存する方法 (上記参照) をお勧めします。
クライアントで設定を更新するもっとも簡単な方法は次のとおりです。
WMI Provider により CurrentValue が検証され、検証に失敗した場合は WBEM_E_FAIL が返されます。IANet_ExtendedStatus オブジェクトの Description 属性では、失敗の理由が返されます。
設定に特有の説明には、次のものがあります。
IANet_SettingEnum、IANet_SettingSlider、または IANet_SettingMultiSelection の現在値が許容値でない際に、上記の説明が返されます。
クライアントが変更可能な設定の唯一の属性は、CurrentValue です。 WMI Provider は、その他の値に加えられた変更を無視します。
メソッド このクラスでサポートされているメソッドはありません。設定を変更するには、必要なプロパティを変更して、PutInstance を呼び出します。
新規チームを作成するには、IANet_TeamOfAdapters のインスタンスを作成して (たとえば、IWbemServices::GetObject() を使用し、IANet_TeamOfAdapters のクラス オブジェクトを取得してから、IWbemServices::SpawnInstance() を使用してこのオブジェクトのインスタンスを作成する)。
次に、IWbemClassObject::Put を使用し、希望のチーム タイプになるように (例: AFT) インスタンスの TeamMode 属性を設定します。 最後に、IWbemServices::PutInstance() を呼び出し、フラッグ WBEM_FLAG_CREATE_ONLY を渡してチームを作成します。
新規チームのオブジェクト パスは、IWbemCallResultObject に保管され、呼び出しが終了した際にユーザに戻されます。 メソッド IWbemCallResult::GetResultString は、新規のオブジェクト パスを取得します。
この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
チームの仮想 IANet_EthernetAdapter および IANet_IPProtocolEndpoint クラスは、Apply への呼び出しが実行されるまで利用できません。 チームの設定は、新しい IANet_TeamOfAdapters に関連付けられた IANet_Configuration オブジェクトを使用してアクセスできます。
アダプタのチームへの追加:
アダプタをチームに追加するには、IANet_TeamedMemberAdapter のインスタンスを作成します。つまり、IWbemServices::GetObject() を使用して IANet_TeamedMemberAdapter のクラス オブジェクトを取得し、IWbemServices::SpawnInstance() を使用してこのオブジェクトのインスタンスを作成します。
IWbemClassObject::Put(): を使用して、オブジェクトの次の属性を設定する必要があります。
また、チーム内のアダプタの優先度を設定することもできます。最後に、IWbemClassObject:: PutInstance を呼び出して WBEM_FLAG_CREATE_ONLY フラグを渡して呼び出し、アダプタをチームに追加します。 この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
アダプタのチームからの削除:
アダプタをチームから削除するには、IWbemServices::DeleteInstance() を使用して、アダプタをチームに関連付ける IANet_TeamedMemberAdapter を削除します。この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
チームの削除:
チームを削除するには、IWbemServices::DeleteInstance() を使用して、IANet_TeamOfAdapters のインスタンスを削除します。 この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
チームのモードの変更:
チームのモードを変更するには、IANet_TeamOfAdapters のインスタンスを入手します。つまり、チームのオブジェクト パスを使用して、IWbemServices::GetObject を使います。 次に、IWbemClassObject::Put を使用して、チームの TeamMode 属性を変更します。 最後に、IWbemClassObject::PutInstance を呼び出して、WMI Provider にチーム モードの更新を告げ、WBEM_FLAG_UPDATE_ONLY フラグを渡します。 この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
アダプタのチーム内での優先度の変更:
アダプタの優先度を変更するには、まずクライアントでアダプタの IANet_TeamedMemberAdapter のインスタンスを入手します。たとえば、オブジェクト パスを使用して IWbemServices::GetObject を使います。次にクライアントで IWbemClassObject::Put を使用して、アダプタの AdapterFunction 属性を変更します。 最後に、IWbemClassObject:: PutInstance を呼び出し、WMI Provider にアダプタの優先度の更新を告げます。 この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
アダプタのアンインストール:
アダプタをアンインストールするには、アンインストールするアダプタのオブジェクト パスを渡して、IWbemServices::DeleteInstance を呼び出します。
VLAN の作成:
VLAN を作成するには、VLAN を追加するアダプタの IANet_802dot1QVLANService に CreateVLAN メソッドを呼び出します。メソッドに次の引数を渡す必要があります。
この機能では、新しく作成された VLAN のオブジェクト パスが、Out パラメータ VLANpath で返されます。この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
VLAN の属性の変更:
クライアントでは、VLAN の VLANNumber 属性と VLANName 属性を変更できます。アダプタの優先度を変更するには、まずアダプタの IANet_VLAN のインスタンスを入手します。たとえば、オブジェクト パスを使って IWbemServices::GetObject を使用します。
次に、VLANNumber か VLANName を希望する値に変更します。 最後に、IWbemClassObject::PutInstance を呼び出して WMI Provider に属性の更新を告げ、WBEM_FLAG_UPDATE_ONLY フラグを渡します。 この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
VLAN の削除:
VLAN を削除するには、削除する VLANのオブジェクト パスを渡して、IWbemServices::DeleteInstance を呼び出します。
Boot Agent の更新:
クライアントは、メソッドの呼び出しを使用して Boot Agent のイメージを更新できます。フラッシュ イメージの読み取り/書き込みを行うには、まずアダプタの IANet_BootAgent のインスタンスを入手します。たとえば、オブジェクト パスを使って IWbemServices::GetObject を使用します。
次に、ReadFlash() を実行して既存のフラッシュ ブート ROM イメージを読み取るか、ProgramFlash() を実行してフラッシュ ブート ROM イメージを更新します。この操作が失敗した場合は、IANet_ExtendedStatus でエラー コードを確認してください。
| タスク | WMI メソッド | 結果 | 注釈 |
| アダプタのブート ROM イメージの更新または挿入 | uint32 ProgramFlash( [IN, ValueMap {"0","1"} , Values {"Check Version", "Write Flash"}:Amended ] uint32 Action, [IN] uint8 NewFlashData[], [OUT] string strErrorMessage ); |
「Check Version」アクションを指定した場合、NewFlashData[] で更新するブート ROM イメージが現在 NIC にあるものよりも古いと、このメソッドでは警告が返されます。 「Write」アクションを指定した場合は、このメソッドによって NIC の FLASH ROM が NewFlashData[] で更新されます。 |
このメソッドは、NIC の Flash ROM の更新に使用されます。これにより、フラッシュの更新中は NIC とネットワークの通信が停止します。 |
| ブート ROM イメージの読み取り | uint32 ReadFlash( [OUT] uint8 FlashData[] ); |
FlashData[] には、NIC の Flash ROM イメージが含まれます。 | このメソッドでは、NIC の Flash ROM が読み取られ、これをファイルに保存することができます。 |
制限と免責条項をすべてお読みください。