CreateSortedAddressPairs 函式
從提供的潛在 IP 目的地地址清單中， CreateSortedAddressPairs 函式會將目的地位址與主機電腦的本機 IP 位址配對在一起，並根據慣用的通訊順序排序配對。
語法
NETIOAPI_API CreateSortedAddressPairs(
_In_opt_ const PSOCKADDR_IN6 SourceAddressList,
_In_ ULONG SourceAddressCount,
_In_ const PSOCKADDR_IN6 DestinationAddressList,
_In_ ULONG DestinationAddressCount,
_In_ ULONG AddressSortOptions,
_In_ PSOCKADDR_IN6_PAIR *SortedAddressPairList,
_Out_ ULONG *SortedAddressPairCount
);
參數
SourceAddressList [in， optional]
保留的。 此參數必須是 Null。SourceAddressCount [in]
保留的。 此參數必須是零。DestinationAddressList [in]
類型 SOCKADDR_IN6之潛在目的地地址清單的指標。DestinationAddressCount [in]
DestinationAddressList參數指向的清單中位址數目。AddressSortOptions [in]
保留的。 此參數必須是零。SortedAddressPairList [in]
來源和目的地位址配對清單的指標，以慣用的通訊順序排序。 如需此參數的詳細資訊，請參閱下列一節。SortedAddressPairCount [out]
SortedAddressPairList參數指向的清單中位址組數目。
傳回值
如果函式成功，CreateSortedAddressPairs會傳回STATUS_SUCCESS。
如果函式失敗， CreateSortedAddressPairs 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 不正確參數已傳遞至 函式。 |
| STATUS_NOT_ENOUGH_MEMORY | 記憶體資源不足，無法完成作業。 |
| 其他 | 使用 FormatMessage 函式來取得傳回錯誤的訊息字串。 |
備註
CreateSortedAddressPairs 函式會自動將主機電腦的本機位址與DestinationAddressList參數指向的潛在目的地地址清單一起配對。
SortedAddressPairList參數指向的位址組傳回清單會排序，讓兩個對等之間最適合通訊的位址組在清單中稍早發生。
SortedAddressPairList參數的類型為 PSOCKADDR_IN6_PAIR，其定義于 Ws2ipdef.h 標頭中，如下所示。
typedef struct _sockaddr_in6_pair
{
PSOCKADDR_IN6 SourceAddress;
PSOCKADDR_IN6 DestinationAddress;
} SOCKADDR_IN6_PAIR, *PSOCKADDR_IN6_PAIR;
- **SourceAddress**
The IP source address.
- **DestinationAddress**
The IP destination address.
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包括 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |