Win32_NetworkAdapterConfiguration クラスの EnableDHCP メソッド
EnableDHCPWMI クラス メソッドを使用すると、このネットワーク アダプターを使用するサービスの動的ホスト構成プロトコル (DHCP) が有効になります。 DHCP を使用すると、IP アドレスを動的に割り当てることができます。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 EnableDHCP();
パラメーター
このメソッドにはパラメーターはありません。
戻り値
再起動が必要ない場合に正常に完了するには 0 (ゼロ)、再起動が必要な場合は正常に完了した場合は 1 (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
注釈
この方法では、マシン上に存在する静的な既定のゲートウェイはクリアされません。
例
TechNet ギャラリーの 「ENABLE DHCP and Assign DNS Servers VBScript」コード サンプルでは、EnableDHCP を使用して DHCP を有効にし、DNS サーバーをコンピューターに割り当てます。
次の VBScript コード サンプルは、 のインスタンスで DHCP の使用を有効にする方法 Win32_NetworkAdapterConfiguration 示しています。 この場合、Index が 0 のアダプターを指定します。 他のインターフェイスの Win32_NetworkAdapter インスタンスから正しいインデックスを選択する必要があります。
注意
NT プラットフォームでのみサポートされます。
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=0")
RetVal = Adapter.EnableDHCP()
if RetVal = 0 then
WScript.Echo "DHCP Enabled"
else
WScript.Echo "DHCP enable failed"
end if
次の Perl コード サンプルは、 のインスタンスで DHCP の使用を有効にする方法 Win32_NetworkAdapterConfiguration 示しています。 この場合、Index が 0 のアダプターを指定します。 他のインターフェイスの Win32_NetworkAdapter インスタンスから正しいインデックスを選択する必要があります。
注意
NT プラットフォームでのみサポートされます。
use strict;
use Win32::OLE;
my ( $Adapter, $RetVal );
eval { $Adapter = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
Get("Win32_NetworkAdapterConfiguration=0"); };
unless ($@)
{
print "\n";
$RetVal = $Adapter->EnableDHCP();
if ( $RetVal == 0)
{
print "DHCP Enabled\n";
}
else
{
print "DHCP enable failed\n";
}
}
else
{
print STDERR Win32::OLE->LastError, "\n";
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|