De functie CreateSortedAddressPairs

In een opgegeven lijst met mogelijke IP-doeladressen koppelt de CreateSortedAddressPairs functie de doeladressen samen met de lokale IP-adressen van de hostmachine en sorteert de paren op basis van de voorkeursvolgorde van communicatie.

Syntaxis

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

Parameters

• SourceAddressList [in, optioneel]
  Gereserveerd. Deze parameter moet worden NULL-.

• SourceAddressCount [in]
  Gereserveerd. Deze parameter moet nul zijn.

• DestinationAddressList [in]
  Een aanwijzer naar een lijst met mogelijke doeladressen van het type SOCKADDR_IN6.

• DestinationAddressCount [in]
  Het aantal adressen in de lijst waarnaar de parameter DestinationAddressList verwijst.

• AddressSortOptions [in]
  Gereserveerd. Deze parameter moet nul zijn.

• SortedAddressPairList [in]
  Een aanwijzer naar een lijst met paren bron- en doeladressen, gesorteerd in de voorkeursvolgorde van communicatie. Zie de volgende sectie Opmerkingen voor meer informatie over deze parameter.

• SortedAddressPairCount [out]
  Het aantal adresparen in de lijst waarnaar de SortedAddressPairList parameter verwijst.

Retourwaarde

CreateSortedAddressPairs retourneert STATUS_SUCCESS als de functie slaagt.

Als de functie mislukt, retourneert CreateSortedAddressPairs een van de volgende foutcodes:

Retourcode	Beschrijving
STATUS_INVALID_PARAMETER	Er is een ongeldige parameter doorgegeven aan de functie.
STATUS_NOT_ENOUGH_MEMORY	Er waren onvoldoende geheugenbronnen beschikbaar om de bewerking te voltooien.
Overige	Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen.

Opmerkingen

Met de functie CreateSortedAddressPairs worden de lokale adressen van de hostcomputer automatisch gekoppeld aan de opgegeven lijst met mogelijke doeladressen waarnaar de DestinationAddressList parameter verwijst.

De geretourneerde lijst met adresparen waarnaar de SortedAddressPairList parameter verwijst, wordt gesorteerd zodat de adresparen die het meest geschikt zijn voor communicatie tussen twee peers eerder in de lijst plaatsvinden.

De parameter SortedAddressPairList is van het type PSOCKADDR_IN6_PAIR, dat als volgt is gedefinieerd in de header 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.

Eisen

Doelplatform	Universal
Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Rubriek	Netioapi.h (inclusief Netioapi.h)
Bibliotheek	Netio.lib
IRQL	< DISPATCH_LEVEL

Zie ook

FormatMessage-

SOCKADDR_IN6