SetIfEntry

SetIfEntry 関数は、インターフェイスの管理状態を設定する。

SetIfEntry pIfRow

pIfRow : [var] 次の構造体へのポインタ

(プラグイン / モジュール : iphlpapi.dll)

解説

SetIfEntry 関数は、インターフェイスの管理状態を設定する。

[戻り値]
関数が成功すると、戻り値は NO_ERROR である。失敗した場合は以下のエラーコードのいずれかが返される。
このドキュメントは省略されている。

[備考]
SetIfEntry 関数は、ローカルコンピュータ上のインターフェイスの管理状態 (administrative status)
を設定する。pIfRow が指す MIB_IFROW の dwIndex メンバはインターフェイスインデックスで初期化しなければならない。
dwIndex が既存のインターフェイスに一致しなければ関数は失敗する。Windows Vista 以降では SetIfEntry は
Administrators グループメンバのみが呼び出せ、それ以外では ERROR_ACCESS_DENIED が返る。UAC
のため、組み込み Administrator 以外のメンバが実行する場合、マニフェストで requestedExecutionLevel
が requireAdministrator でないと失敗する。マニフェストがない場合は RunAs administrator
実行が必要である。
Note: Windows NT 4.0 および Windows 2000
以降では、この関数は特権操作を実行する。成功するには、呼び出し元が Administrators グループまたは
NetworkConfigurationOperators グループのメンバとしてログオンしている必要がある。

情報