CreateSortedAddressPairs – funkce

Ze zadaného seznamu potenciálních cílových IP adres CreateSortedAddressPairs funkce spáruje cílové adresy společně s místními IP adresami hostitelského počítače a seřadí páry podle upřednostňovaného pořadí komunikace.

Syntax

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, optional]
  Rezervovaný. Tento parametr musí být null.

• SourceAddressCount [in]
  Rezervovaný. Tento parametr musí být nula.

• DestinationAddressList [in]
  Ukazatel na seznam potenciálních cílových adres typu SOCKADDR_IN6.

• DestinationAddressCount [in]
  Počet adres v seznamu, na které odkazuje parametr DestinationAddressList.

• AddressSortOptions [in]
  Rezervovaný. Tento parametr musí být nula.

• SortedAddressPairList [in]
  Ukazatel na seznam dvojic zdrojových a cílových adres seřazených v upřednostňovaném pořadí komunikace. Další informace o tomto parametru najdete v následující části Poznámky.

• SortedAddressPairCount [out]
  Počet dvojic adres v seznamu, na který odkazuje parametr SortedAddressPairList.

Návratová hodnota

CreateSortedAddressPairs vrátí STATUS_SUCCESS, pokud bude funkce úspěšná.

Pokud funkce selže, CreateSortedAddressPairs vrátí jeden z následujících kódů chyb:

Návratový kód	Popis
STATUS_INVALID_PARAMETER	Funkci byla předána neplatná hodnota parametru.
STATUS_NOT_ENOUGH_MEMORY	K dokončení operace byly k dispozici nedostatečné paměťové prostředky.
Jiné	Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu.

Poznámky

Funkce CreateSortedAddressPairs automaticky spáruje místní adresy hostitelského počítače spolu se zadaným seznamem potenciálních cílových adres, na které odkazuje parametr DestinationAddressList.

Vrácený seznam dvojic adres, na které SortedAddressPairList parametr odkazuje, je seřazen tak, aby páry adres, které jsou nejvhodnější pro komunikaci mezi dvěma partnerskými uzly dříve v seznamu.

Parametr SortedAddressPairList je typu PSOCKADDR_IN6_PAIR, který je definován v hlavičce Ws2ipdef.h následujícím způsobem.

    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.

Požadavky

Cílová platforma	univerzální
Verze	K dispozici v systémech Windows Vista a novějších verzích operačních systémů Windows.
Záhlaví	Netioapi.h (včetně Netioapi.h)
Knihovna	Netio.lib
IRQL	< DISPATCH_LEVEL

Viz také

FormatMessage

SOCKADDR_IN6