SetUnicastIpAddressEntry

ローカルコンピュータ上の既存のユニキャスト IP アドレスエントリのプロパティを設定する。

SetUnicastIpAddressEntry Row

Row : [var] 既存のユニキャスト IP アドレスエントリの MIB_UNICASTIPADDRESS_ROW 構造体エントリへのポインタ。

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

解説

ローカルコンピュータ上の既存のユニキャスト IP アドレスエントリのプロパティを設定する。

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

[備考]
SetUnicastIpAddressEntry 関数は Windows Vista 以降で定義される。通常は
GetUnicastIpAddressEntry で既存の MIB_UNICASTIPADDRESS_ROW
を取得し、変更したいメンバを書き換えて SetUnicastIpAddressEntry
を呼ぶ。InitializeUnicastIpAddressEntry で既定値に初期化する方法も使えるが、その際は呼び出し前に
InterfaceLuid または InterfaceIndex を保存し、呼び出し後に復元するのが普通である。Row の Address
メンバは有効なユニキャスト IPv4 または IPv6 アドレスとファミリで初期化し、InterfaceLuid または
InterfaceIndex のいずれかを初期化する (前者が 0 なら後者が使われる)。OnLinkPrefixLength を 255
に設定すると、IP アドレス長と同じ値 (IPv4 なら 32、IPv6 なら 128) に設定される。IPv4 のサブネットマスクや
IPv6
のリンクプレフィックスが不正になる場合は事前に正しい値に設定する必要がある。DadState、ScopeId、CreationTimeStamp
は呼び出し時に無視される (ネットワークスタックが設定)。ScopeId
はアドレスが追加されたインターフェイスにより自動的に決定される。Administrators グループメンバのみが呼び出せ、それ以外は
ERROR_ACCESS_DENIED。UAC のため、組み込み Administrator 以外は
requestedExecutionLevel=requireAdministrator または RunAs administrator
実行が必要。

情報