CreateSortedAddressPairs işlevi

Sağlanan olası IP hedef adresleri listesinden CreateSortedAddressPairs işlevi hedef adresleri konak makinenin yerel IP adresleriyle eşleştirir ve çiftleri tercih edilen iletişim sırasına göre sıralar.

Sözdizimi

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

Parametre

• SourceAddressList [in, isteğe bağlı]
  Ayrılmış. Bu parametre null olmalıdır.

• SourceAddressCount [in]
  Ayrılmış. Bu parametre sıfır olmalıdır.

• DestinationAddressList [in]
  SOCKADDR_IN6türünde olası hedef adreslerin listesinin işaretçisi.

• DestinationAddressCount [in]
  DestinationAddressList parametresinin işaret olduğu listedeki adres sayısı.

• AddressSortOptions [in]
  Ayrılmış. Bu parametre sıfır olmalıdır.

• SortedAddressPairList [in]
  Kaynak ve hedef adres çiftlerinin listesinin, tercih edilen iletişim düzenine göre sıralanmış bir işaretçi. Bu parametre hakkında daha fazla bilgi için aşağıdaki Açıklamalar bölümüne bakın.

• SortedAddressPairCount [out]
  SortedAddressPairList parametresinin işaret olduğu listedeki adres çiftlerinin sayısı.

Dönüş değeri

CreateSortedAddressPairs işlevi başarılı olursa STATUS_SUCCESS döndürür.

İşlev başarısız olursa CreateSortedAddressPairs aşağıdaki hata kodlarından birini döndürür:

İade kodu	Açıklama
STATUS_INVALID_PARAMETER	İşleve geçersiz bir parametre geçirildi.
STATUS_NOT_ENOUGH_MEMORY	İşlemi tamamlamak için bellek kaynakları yetersizdi.
Diğer	Döndürülen hatanın ileti dizesini almak için FormatMessage işlevini kullanın.

Açıklamalar

CreateSortedAddressPairs işlevi, konak makinenin yerel adreslerini, DestinationAddressList parametresinin işaret ettiği olası hedef adreslerin listesiyle otomatik olarak eşleştirir.

SortedAddressPairList parametresinin işaretlendiği adres çiftlerinin döndürülen listesi, iki eş arasındaki iletişim için en uygun adres çiftlerinin listenin önceki bölümlerinde gerçekleşmesi için sıralanır.

SortedAddressPairList parametresi, Ws2ipdef.h üst bilgisinde aşağıdaki gibi tanımlanan PSOCKADDR_IN6_PAIR türündedir.

    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.

Gereksinim -leri

Hedef platform	Evrensel
Sürüm	Windows Vista ve Windows işletim sistemlerinin sonraki sürümlerinde kullanılabilir.
Üstbilgi	Netioapi.h (Netioapi.h içerir)
Kütüphane	Netio.lib
IRQL	< DISPATCH_LEVEL

Ayrıca bkz.

FormatMessage

SOCKADDR_IN6