Поделиться через

Функция 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 [в, необязательно]
    Зарезервировано. Этот параметр должен иметь значение 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

См. также раздел

FormatMessage

SOCKADDR_IN6