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 |