Fonction CreateSortedAddressPairs
À partir d’une liste fournie d’adresses IP de destination potentielles, la fonction CreateSortedAddressPairs associe les adresses de destination aux adresses IP locales de l’ordinateur hôte et trie les paires en fonction de l’ordre de communication préféré.
Syntaxe
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ètres
SourceAddressList [in, facultatif]
Réservé. Ce paramètre doit avoir la valeur NULL.SourceAddressCount [in]
Réservé. Ce paramètre doit être égal à zéro.DestinationAddressList [in]
Pointeur vers une liste d’adresses de destination potentielles de type SOCKADDR_IN6.DestinationAddressCount [in]
Nombre d’adresses dans la liste vers laquelle pointe le paramètre DestinationAddressList .AddressSortOptions [in]
Réservé. Ce paramètre doit être égal à zéro.TridAddressPairList [in]
Pointeur vers une liste de paires d’adresses source et de destination, triées dans l’ordre de communication préféré. Pour plus d’informations sur ce paramètre, consultez la section Remarques suivante.TridAddressPairCount [out]
Nombre de paires d’adresses dans la liste vers laquelle pointe le paramètre SortedAddressPairList .
Valeur retournée
CreateSortedAddressPairs retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, CreateSortedAddressPairs retourne l’un des codes d’erreur suivants :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été transmis à la fonction. |
| STATUS_NOT_ENOUGH_MEMORY | Les ressources de mémoire étaient insuffisantes pour terminer l’opération. |
| Autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Notes
La fonction CreateSortedAddressPairs associe automatiquement les adresses locales de l’ordinateur hôte à la liste fournie d’adresses de destination potentielles vers laquelle pointe le paramètre DestinationAddressList .
La liste retournée des paires d’adresses vers laquelle pointe le paramètre TridAddressPairList est triée afin que les paires d’adresses les mieux adaptées à la communication entre deux homologues se produisent plus tôt dans la liste.
Le paramètre SortedAddressPairList est de type PSOCKADDR_IN6_PAIR, qui est défini dans l’en-tête Ws2ipdef.h comme suit.
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.
Spécifications
Plateforme cible |
Universal |
Version |
Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |
Bibliothèque |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |