CreateSortedAddressPairs függvény

A lehetséges IP-címeket tartalmazó megadott listából a CreateSortedAddressPairs függvény párosítja a célcímeket a gazdagép helyi IP-címeivel, és a párokat az előnyben részesített kommunikációs sorrend szerint rendezi.

Szintaxis

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

Paraméterek

• SourceAddressList [be, nem kötelező]
  Tartózkodó. Ennek a paraméternek NULLkell lennie.

• SourceAddressCount [in]
  Tartózkodó. Ennek a paraméternek nullának kell lennie.

• DestinationAddressList [in]
  Az SOCKADDR_IN6típusú lehetséges célcímek listájára mutató mutató.

• DestinationAddressCount [in]
  Azon címek száma a listában, amelyekre a DestinationAddressList paraméter hivatkozik.

• AddressSortOptions [in]
  Tartózkodó. Ennek a paraméternek nullának kell lennie.

• SortedAddressPairList [in]
  Mutató a forrás- és célcímpárok listájára, az előnyben részesített kommunikációs sorrend szerint rendezve. A paraméterről további információt a következő Megjegyzések szakaszban talál.

• SortedAddressPairCount [ki]
  Azon címpárok száma a listában, amelyekre a SortedAddressPairList paraméter mutat.

Visszaadott érték

CreateSortedAddressPairs a függvény sikeres működése esetén STATUS_SUCCESS ad vissza.

Ha a függvény meghiúsul, CreateSortedAddressPairs a következő hibakódok egyikét adja vissza:

Kód visszaadása	Leírás
STATUS_INVALID_PARAMETER	Érvénytelen paraméter lett átadva a függvénynek.
STATUS_NOT_ENOUGH_MEMORY	A művelet végrehajtásához nem volt elegendő memóriaerőforrás.
Egyéb	A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

A CreateSortedAddressPairs függvény automatikusan párosítja a gazdagép helyi címét a DestinationAddressList paraméter által megadott lehetséges célcímek listájával.

A SortedAddressPairList paraméterpontok által visszaadott címpárok listája úgy van rendezve, hogy a két társ közötti kommunikációhoz leginkább megfelelő címpárok a lista korábbi részében forduljanak elő.

A SortedAddressPairList paraméter PSOCKADDR_IN6_PAIR típusú, amely a Ws2ipdef.h fejlécben az alábbiak szerint van definiálva.

    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.

Követelmények

Célplatform	Univerzális
Verzió	Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban.
Fejléc	Netioapi.h (netioapi.h)
Könyvtár	Netio.lib
IRQL	< DISPATCH_LEVEL

Lásd még:

FormatMessage

SOCKADDR_IN6