IpRenewAddress

IpRenewAddress 関数は、DHCP で以前に取得した IPv4 アドレスのリースを更新する。

IpRenewAddress AdapterInfo

AdapterInfo : [var] 更新する IP アドレスに関連するアダプタを指定する IP_ADAPTER_INDEX_MAP 構造体へのポインタ。

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

解説

IpRenewAddress 関数は、DHCP で以前に取得した IPv4 アドレスのリースを更新する。

[戻り値]
関数が成功すると、戻り値は NO_ERROR である。失敗した場合は FormatMessage
を使って返されたエラーのメッセージ文字列を取得する。
このドキュメントは省略されている。

[備考]
IpRenewAddress 関数は IPv4 専用で、DHCP で以前に取得した IPv4
アドレスのみを更新する。AdapterInfo が指す IP_ADAPTER_INDEX_MAP の Name メンバのみが更新する
DHCP アドレスの判定に使われる。IP_ADAPTER_INDEX_MAP の配列は GetInterfaceInfo によって
IP_INTERFACE_INFO 構造体として返される。GetInterfaceInfo の返す IP_INTERFACE_INFO
は、NumAdapters が 0 (IPv4 有効なアダプタがない) の場合でも最低 1 つの IP_ADAPTER_INDEX_MAP
を含む。このとき単一の IP_ADAPTER_INDEX_MAP のメンバ値は未定義である。Name メンバが NULL
の場合、IpRenewAddress は ERROR_INVALID_PARAMETER を返す。IPv6
アドレスの解放/更新を行う関数は提供されていない。これは Ipconfig コマンドの実行でのみ可能:
ipconfig /release6 ipconfig /renew6

情報