Win32_NetworkAdapterConfiguration クラスの SetIPConnectionMetric メソッド
SetIPConnectionMetric メソッドは、この IP バインド アダプターに関連付けられているルーティング メトリックを設定するために使用されます。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 SetIPConnectionMetric(
[in] uint32 IPConnectionMetric
);
パラメーター
-
IPConnectionMetric [in]
-
この IP バインド アダプターに対して構成されたルートを使用するコストを示します。 この値は、IP ルーティング テーブル内のそれらのルートに対して重み付けされます。 ルーティング テーブル内の宛先へのルートが複数ある場合は、メトリックが最も低いルートが使用されます。 有効な値の範囲は 1 ~ 9999 です。 既定値は 1 です。
戻り値
再起動が必要ない場合に正常に完了するには 0 (ゼロ) の値を返し、再起動が必要な場合は正常に完了するには 1 を返し、エラーがある場合は別の数値を返します。 エラー コードの詳細については、「 WMI エラー定数 」または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。
-
正常に完了し、再起動は必要ありません
-
0
正常に完了しました。再起動は必要ありません。
-
正常に完了し、再起動が必要です
-
1
正常に完了しました。再起動が必要です。
-
このプラットフォームではサポートされていないメソッド
-
64
メソッドは、このプラットフォームではサポートされていません。
-
不明なエラー
-
65
不明なエラー。
-
サブネット マスクが無効です
-
66
サブネット マスクが無効です。
-
返されたインスタンスの処理中にエラーが発生しました
-
67
返されたインスタンスの処理中にエラーが発生しました。
-
入力パラメーターが無効です
-
68
入力パラメーターが無効です。
-
5 つ以上のゲートウェイが指定されています
-
69
5 つ以上のゲートウェイが指定されています。
-
IP アドレスが無効です
-
70
IP アドレスが無効です。
-
無効なゲートウェイ IP アドレス
-
71
ゲートウェイ IP アドレスが無効です。
-
要求された情報のレジストリへのアクセス中にエラーが発生しました
-
72
要求された情報のレジストリへのアクセス中にエラーが発生しました。
-
無効なドメイン名
-
73
ドメイン名が無効です。
-
ホスト名が無効です
-
74
ホスト名が無効です。
-
プライマリ/セカンダリ WINS サーバーが定義されていません
-
75
プライマリまたはセカンダリ WINS サーバーが定義されていません。
-
無効なファイル
-
76
無効なファイルです。
-
無効なシステム パス
-
77
システム パスが無効です。
-
ファイルのコピーに失敗しました
-
78
ファイルのコピーに失敗しました。
-
無効なセキュリティ パラメーター
-
79
セキュリティ パラメーターが無効です。
-
TCP/IP サービスを構成できない
-
80
TCP/IP サービスを構成できません。
-
DHCP サービスを構成できない
-
81
DHCP サービスを構成できません。
-
DHCP リースを更新できない
-
82
DHCP リースを更新できません。
-
DHCP リースを解放できない
-
83
DHCP リースを解放できません。
-
アダプターで IP が有効になっていない
-
84
アダプターで IP が有効になっていません。
-
アダプターで IPX が有効になっていない
-
85
アダプターで IPX が有効になっていません。
-
フレーム/ネットワーク番号の境界エラー
-
86
フレームまたはネットワーク番号の境界エラー。
-
フレームの種類が無効です
-
87
フレームの種類が無効です。
-
ネットワーク番号が無効です
-
88
ネットワーク番号が無効です。
-
重複するネットワーク番号
-
89
重複するネットワーク番号。
-
パラメーターの範囲外
-
90
パラメーターが範囲外です。
-
アクセスが拒否されました
-
91
アクセスが拒否されました。
-
メモリ不足
-
92
メモリが不足しています。
-
既に存在する
-
93
既に存在します。
-
パス、ファイル、またはオブジェクトが見つかりません
-
94
パス、ファイル、またはオブジェクトが見つかりません。
-
サービスに通知できない
-
95
サービスに通知できません。
-
DNS サービスに通知できない
-
96
DNS サービスに通知できません。
-
インターフェイスが構成できない
-
97
インターフェイスは構成できません。
-
すべての DHCP リースをリリースまたは更新できない
-
98
すべての DHCP リースを解放または更新できるわけではありません。
-
アダプターで DHCP が有効になっていない
-
100
アダプターで DHCP が有効になっていません。
-
その他
-
101 4294967295
例
ネットワーク アダプターの IP 接続メトリックの変更 VBScript サンプルでは、ネットワーク アダプターの IP 接続メトリックを 100 に設定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista、Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008、Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|