CreateSortedAddressPairs-Funktion
Aus einer angegebenen Liste potenzieller IP-Zieladressen koppelt die CreateSortedAddressPairs-Funktion die Zieladressen 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 Parameter DestinationAddressList verweist.AddressSortOptions [in]
Reserviert. Dieser Parameter muss null sein.SortedAddressPairList [in]
Ein Zeiger auf eine Liste von Quell- und Zieladressenpaaren, 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 der Parameter SortedAddressPairList 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 | Es wurde ein ungültiger Parameter an die Funktion übergeben. |
| STATUS_NOT_ENOUGH_MEMORY | Zum Abschließen des Vorgangs waren unzureichende Arbeitsspeicherressourcen verfügbar. |
| Andere | Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Bemerkungen
Die CreateSortedAddressPairs-Funktion koppelt automatisch die lokalen Adressen des Hostcomputers mit der angegebenen Liste potenzieller Zieladressen, auf die der Parameter DestinationAddressList verweist.
Die zurückgegebene Liste von Adresspaaren, auf die der Parameter SortedAddressPairList verweist, wird so sortiert, dass die Adresspaare, die für die Kommunikation zwischen zwei Peers am besten geeignet sind, weiter oben in der Liste auftreten.
Der Parameter SortedAddressPairList hat den Typ PSOCKADDR_IN6_PAIR, der im Ws2ipdef.h-Header wie folgt definiert wird.
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 |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |