Función CreateSortedAddressPairs
En una lista proporcionada de posibles direcciones de destino IP, la función CreateSortedAddressPairs empareja las direcciones de destino junto con las direcciones IP locales del equipo host y ordena los pares según el orden preferido de comunicación.
Sintaxis
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
);
Parámetros
SourceAddressList [in, optional]
Reservado. Este parámetro debe ser NULL.SourceAddressCount [in]
Reservado. Este parámetro debe ser cero.DestinationAddressList [in]
Puntero a una lista de posibles direcciones de destino de tipo SOCKADDR_IN6.DestinationAddressCount [in]
Número de direcciones de la lista a las que apunta el parámetro DestinationAddressList .AddressSortOptions [in]
Reservado. Este parámetro debe ser cero.SortedAddressPairList [in]
Puntero a una lista de pares de direcciones de origen y destino, ordenadas en el orden preferido de comunicación. Para obtener más información sobre este parámetro, vea la siguiente sección Comentarios.SortedAddressPairCount [out]
Número de pares de direcciones de la lista a los que apunta el parámetro SortedAddressPairList .
Valor devuelto
CreateSortedAddressPairs devuelve STATUS_SUCCESS si la función se realiza correctamente.
Si se produce un error en la función, CreateSortedAddressPairs devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Se pasó un parámetro no válido a la función. |
| STATUS_NOT_ENOUGH_MEMORY | No había suficientes recursos de memoria disponibles para completar la operación. |
| Otros | Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Observaciones
La función CreateSortedAddressPairs empareja automáticamente las direcciones locales del equipo host junto con la lista proporcionada de posibles direcciones de destino a las que apunta el parámetro DestinationAddressList .
La lista de pares de direcciones devueltas a las que apunta el parámetro SortedAddressPairList se ordena para que los pares de direcciones más adecuados para la comunicación entre dos pares se produzcan anteriormente en la lista.
El parámetro SortedAddressPairList es de tipo PSOCKADDR_IN6_PAIR, que se define en el encabezado Ws2ipdef.h como se indica a continuación.
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.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |