CreateSortedAddressPairs

与えられた IP 宛先候補リストに対し、ホストのローカル IP アドレスとペアを作り、通信に最適な順序でソートして返す。

CreateSortedAddressPairs SourceAddressList, SourceAddressCount, DestinationAddressList, DestinationAddressCount, AddressSortOptions, SortedAddressPairList, SortedAddressPairCount

SourceAddressList : [var] NULL でなければならない。将来使用のために予約されている。
SourceAddressCount : [int] 0 でなければならない。将来使用のために予約されている。
DestinationAddressList : [var] IPv6 候補宛先アドレスの一覧を格納する SOCKADDR_IN6 構造体配列へのポインタ。IPv4 アドレスは IPv4-mapped IPv6 形式で表現する必要がある。
DestinationAddressCount : [int] DestinationAddressList が指す宛先アドレスの個数。
AddressSortOptions : [int] 将来使用のために予約されている。
SortedAddressPairList : [var] 成功時に通信に最適な順序でソートされた IPv6 アドレスペアの SOCKADDR_IN6_PAIR 構造体配列を受け取るポインタ。
SortedAddressPairCount : [var] 成功時に SortedAddressPairList 配列の要素数を受け取る変数へのポインタ。

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

解説

与えられた IP 宛先候補リストに対し、ホストのローカル IP アドレスとペアを作り、通信に最適な順序でソートして返す。

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

[備考]
CreateSortedAddressPairs 関数は Windows Vista 以降で定義される。送信元と宛先の IPv6
アドレスリストを受け取り、通信に最適な順序でソートしたアドレスペアのリストを返す。SourceAddressList と
SourceAddressCount は現在予約されており、それぞれ NULL と 0
でなければならない。本関数はホストの全ローカルアドレスを送信元として用いる。DestinationAddressList は
SOCKADDR_IN6 の配列で、IPv4 は IPv4-mapped IPv6
形式で表現する。DestinationAddressCount は 500 まで。成功時、SortedAddressPairList
はソート済みの SOCKADDR_IN6_PAIR 配列を指す。不要になったら FreeMibTable で解放する。

情報