Freigeben über


CreateSortedAddressPairs-Funktion

Aus einer angegebenen Liste potenzieller IP-Zieladressen koppelt die CreateSortedAddressPairs Funktionsadressen die Zieladressen zusammen mit den lokalen IP-Adressen des Hostcomputers und sortiert die Paare nach der bevorzugten Kommunikationsreihenfolge.

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

Parameter

  • SourceAddressList- [in, optional]
    Reserviert. Dieser Parameter muss NULL-sein.

  • SourceAddressCount- [in]
    Reserviert. Dieser Parameter muss null sein.

  • DestinationAddressList- [in]
    Ein Zeiger auf eine Liste potenzieller Zieladressen vom Typ SOCKADDR_IN6.

  • DestinationAddressCount [in]
    Die Anzahl der Adressen in der Liste, auf die der DestinationAddressList Parameter verweist.

  • AddressSortOptions- [in]
    Reserviert. Dieser Parameter muss null sein.

  • SortedAddressPairList [in]
    Ein Zeiger auf eine Liste von Quell- und Zieladressen, sortiert in der bevorzugten Reihenfolge der Kommunikation. Weitere Informationen zu diesem Parameter finden Sie im folgenden Abschnitt "Hinweise".

  • SortedAddressPairCount [out]
    Die Anzahl der Adresspaare in der Liste, auf die die SortedAddressPairList Parameter verweist.

Rückgabewert

CreateSortedAddressPairs gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.

Wenn die Funktion fehlschlägt, gibt CreateSortedAddressPairs einen der folgenden Fehlercodes zurück:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER

An die Funktion wurde ein ungültiger Parameter übergeben.

STATUS_NOT_ENOUGH_MEMORY

Unzureichende Arbeitsspeicherressourcen waren verfügbar, um den Vorgang abzuschließen.

Andere

Verwenden Sie die FormatMessage--Funktion, um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Bemerkungen

Die funktion CreateSortedAddressPairs funktion koppelt die lokalen Adressen des Hostcomputers automatisch mit der angegebenen Liste der potenziellen Zieladressen, auf die der DestinationAddressList Parameter verweist.

Die zurückgegebene Liste der Adressenpaare, auf die die SortedAddressPairList Parameter verweist, wird sortiert, sodass die Adresspaare, die am besten für die Kommunikation zwischen zwei Peers geeignet sind, weiter oben in der Liste auftreten.

Der SortedAddressPairList Parameter ist vom Typ PSOCKADDR_IN6_PAIR, der im Ws2ipdef.h-Header wie folgt definiert ist.

    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.

Anforderungen

Zielplattform

universelle

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Kopfball

Netioapi.h (include Netioapi.h)

Bibliothek

Netio.lib

IRQL

< DISPATCH_LEVEL

Siehe auch

FormatMessage-

SOCKADDR_IN6