CreateSortedAddressPairs, funkcja

Z podanej listy potencjalnych adresów docelowych IP CreateSortedAddressPairs funkcja paruje adresy docelowe wraz z lokalnymi adresami IP maszyny hosta i sortuje pary zgodnie z preferowaną kolejnością komunikacji.

Składnia

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
);

Parametry

• SourceAddressList [in, opcjonalnie]
  Zastrzeżony. Ten parametr musi mieć wartość null.

• SourceAddressCount [in]
  Zastrzeżony. Ten parametr musi mieć wartość zero.

• DestinationAddressList [in]
  Wskaźnik do listy potencjalnych adresów docelowych typu SOCKADDR_IN6.

• DestinationAddressCount [in]
  Liczba adresów na liście wskazujących DestinationAddressList parametru.

• AddressSortOptions [in]
  Zastrzeżony. Ten parametr musi mieć wartość zero.

• SortedAddressPairList [in]
  Wskaźnik do listy par adresów źródłowych i docelowych posortowanych w preferowanej kolejności komunikacji. Aby uzyskać więcej informacji na temat tego parametru, zobacz następującą sekcję Uwagi.

• SortedAddressPairCount [out]
  Liczba par adresów na liście, do których wskazuje SortedAddressPairList parametru.

Wartość zwracana

CreateSortedAddressPairs zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.

Jeśli funkcja nie powiedzie się, CreateSortedAddressPairs zwraca jeden z następujących kodów błędów:

Uwagi

Funkcja CreateSortedAddressPairs automatycznie paruje adresy lokalne maszyny hosta wraz z podaną listą potencjalnych adresów docelowych, do których wskazuje DestinationAddressList parametru.

Zwrócona lista par adresów, do których SortedAddressPairList wskazuje parametr, jest sortowana tak, aby pary adresów, które najlepiej nadają się do komunikacji między dwoma elementami równorzędnymi, wystąpiły wcześniej na liście.

SortedAddressPairList parametr jest typu PSOCKADDR_IN6_PAIR, który jest zdefiniowany w nagłówku Ws2ipdef.h w następujący sposób.

    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.

Wymagania

Zobacz też

FormatMessage

SOCKADDR_IN6