Funzione CreateSortedAddressPairs

Articolo
03/08/2023

Da un elenco fornito di potenziali indirizzi IP di destinazione, la funzione CreateSortedAddressPairs associa gli indirizzi di destinazione insieme agli indirizzi IP locali del computer host e ordina le coppie in base all'ordine di comunicazione preferito.

Sintassi

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
);

Parametri

SourceAddressList [in, facoltativo]
Riservato. Questo parametro deve essere NULL.
SourceAddressCount [in]
Riservato. Questo parametro deve essere zero.
DestinationAddressList [in]
Puntatore a un elenco di potenziali indirizzi di destinazione di tipo SOCKADDR_IN6.
DestinationAddressCount [in]
Numero di indirizzi nell'elenco a cui punta il parametro DestinationAddressList .
AddressSortOptions [in]
Riservato. Questo parametro deve essere zero.
SortedAddressPairList [in]
Puntatore a un elenco di coppie di indirizzi di origine e di destinazione, ordinati nell'ordine di comunicazione preferito. Per altre informazioni su questo parametro, vedere la sezione Osservazioni seguente.
SortedAddressPairCount [out]
Numero di coppie di indirizzi nell'elenco a cui punta il parametro SortedAddressPairList .

Valore restituito

CreateSortedAddressPairs restituisce STATUS_SUCCESS se la funzione ha esito positivo.

Se la funzione non riesce, CreateSortedAddressPairs restituisce uno dei codici di errore seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
STATUS_NOT_ENOUGH_MEMORY	Risorse di memoria insufficienti per completare l'operazione.
Altri	Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

La funzione CreateSortedAddressPairs associa automaticamente gli indirizzi locali del computer host insieme all'elenco fornito di potenziali indirizzi di destinazione a cui punta il parametro DestinationAddressList .

L'elenco restituito di coppie di indirizzi a cui punta il parametro SortedAddressPairList viene ordinato in modo che le coppie di indirizzi più adatte per la comunicazione tra due peer si verifichino in precedenza nell'elenco.

Il parametro SortedAddressPairList è di tipo PSOCKADDR_IN6_PAIR, definito nell'intestazione Ws2ipdef.h come indicato di seguito.

    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.

Requisiti

Piattaforma di destinazione	Universale
Versione	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	Netioapi.h (include Netioapi.h)
Libreria	Netio.lib
IRQL	< DISPATCH_LEVEL

Vedi anche

FormatMessage

SOCKADDR_IN6

Condividi tramite