Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Dans une liste fournie d’adresses IP potentielles, les CreateSortedAddressPairs fonction associent les adresses de destination avec les adresses IP locales de l’ordinateur hôte et trient 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 être 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.SortedAddressPairList [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.SortedAddressPairCount [out]
Nombre de paires d’adresses dans la liste vers laquelle le paramètre TridAddressPairList pointe.
Valeur de retour
CreateSortedAddressPairs retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, CreateSortedAddressPairs retourne l’un des codes d’erreur suivants :
| Retourner le code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été passé à la fonction. |
| STATUS_NOT_ENOUGH_MEMORY | Les ressources de mémoire insuffisantes étaient disponibles pour terminer l’opération. |
| autres | Utilisez la fonction FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Remarques
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 renvoyée des paires d’adresses que le TridAddressPairList points de paramètre est triée afin que les paires d’adresses qui conviennent le mieux à la communication entre deux homologues se produisent précédemment 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.