Fungsi CreateSortedAddressPairs

Dari daftar alamat tujuan IP potensial yang disediakan, fungsi CreateSortedAddressPairs memasangkan alamat tujuan bersama dengan alamat IP lokal komputer host dan mengurutkan pasangan sesuai dengan urutan komunikasi yang diinginkan.

Sintaksis

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

Parameter

• SourceAddressList [in, opsional]
  Dipesan. Parameter ini harus null.

• SourceAddressCount [in]
  Dipesan. Parameter ini harus nol.

• DestinationAddressList [in]
  Penunjuk ke daftar alamat tujuan potensial jenis SOCKADDR_IN6.

• DestinationAddressCount [in]
  Jumlah alamat dalam daftar yang ditunjuk oleh parameter DestinationAddressList.

• AddressSortOptions [in]
  Dipesan. Parameter ini harus nol.

• SortedAddressPairList [in]
  Penunjuk ke daftar pasangan alamat sumber dan tujuan, diurutkan dalam urutan komunikasi yang disukai. Untuk informasi selengkapnya tentang parameter ini, lihat bagian Komentar berikut ini.

• SortedAddressPairCount [out]
  Jumlah pasangan alamat dalam daftar yang ditunjuk oleh parameter SortedAddressPairList.

Mengembalikan nilai

CreateSortedAddressPairs mengembalikan STATUS_SUCCESS jika fungsi berhasil.

Jika fungsi gagal, CreateSortedAddressPairs mengembalikan salah satu kode kesalahan berikut:

Mengembalikan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
STATUS_NOT_ENOUGH_MEMORY	Sumber daya memori tidak cukup tersedia untuk menyelesaikan operasi.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

Fungsi CreateSortedAddressPairs secara otomatis memasangkan alamat lokal komputer host bersama dengan daftar alamat tujuan potensial yang disediakan yang ditunjuk oleh parameter DestinationAddressList.

Daftar pasangan alamat yang dikembalikan yang parameter sortedAddressPairList menunjuk ke diurutkan sehingga pasangan alamat yang paling cocok untuk komunikasi antara dua rekan terjadi sebelumnya dalam daftar.

Parameter SortedAddressPairList berjenis PSOCKADDR_IN6_PAIR, yang didefinisikan dalam header Ws2ipdef.h sebagai berikut.

    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.

Persyaratan

Platform target	Universal
Versi	Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru.
Header	Netioapi.h (termasuk Netioapi.h)
Perpustakaan	Netio.lib
IRQL	< DISPATCH_LEVEL

Lihat juga

FormatMessage

SOCKADDR_IN6