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


Функция 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, необязательный]
    Скрытный. Этот параметр должен быть 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 автоматически связывает локальные адреса хост-компьютера вместе с указанным списком потенциальных целевых адресов, на которые указывает параметр DestinationAddress List.

Возвращенный список пар адресов, которые SortedAddressPair List указывает на сортировку параметров, чтобы пары адресов, которые лучше всего подходили для обмена данными между двумя одноранговыми узлами, выполнялись ранее в списке.

Параметр 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 (include Netioapi.h)

Библиотека

Netio.lib

IRQL

< DISPATCH_LEVEL

См. также

FormatMessage

SOCKADDR_IN6