Fungsi DrtCreateIpv6UdpTransport (drt.h)

Artikel
08/23/2023

Fungsi DrtCreateIpv6UdpTransport membuat transportasi berdasarkan protokol UDP IPv6.

Sintaks

HRESULT DrtCreateIpv6UdpTransport(
            DRT_SCOPE      scope,
            ULONG          dwScopeId,
            ULONG          dwLocalityThreshold,
  [in, out] USHORT         *pwPort,
  [out]     HDRT_TRANSPORT *phTransport
);

Parameter

scope

Enumerasi DRT_SCOPE yang menentukan cakupan IPv6 tempat DRT beroperasi.

dwScopeId

Pengidentifikasi yang secara unik menentukan antarmuka yang terkait dengan cakupan.

Untuk cakupan Global, parameter ini selalu merupakan ID "GLOBAL_" dan bersifat opsional saat hanya menggunakan cakupan global. Untuk cakupan lokal tautan, parameter ini mewakili antarmuka yang terkait dengan Kartu Antarmuka Jaringan tempat cakupan lokal tautan berada.

dwLocalityThreshold

Pengidentifikasi yang menentukan bagaimana informasi Lokalitas berdasarkan alamat IpV6 digunakan saat penembolokan tetangga. Secara default, DRT memberikan preferensi kepada tetangga yang memiliki alamat IPv6 dengan awalan yang sama dengan komputer lokal.

[in, out] pwPort

Penunjuk ke port yang digunakan oleh instans DRT lokal.

[out] phTransport

Penunjuk ke handel transportasi DRT yang ditentukan dalam struktur DRT_SETTINGS .

Mengembalikan nilai

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk:

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Sistem tidak dapat mengalokasikan memori untuk penyedia.
DRT_E_INVALID_PORT	pwPort adalah NULL.
DRT_E_INVALID_TRANSPORT_PROVIDER	hTransport adalah NULL.
DRT_E_INVALID_SCOPE	Cakupan yang ditentukan tidak DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE, atau DRT_LINK_LOCAL_SCOPE.
DRT_E_TRANSPORT_UNEXPECTED	Terjadi kesalahan tidak terduga. Lihat TraceError karena alasannya.

Catatan Fungsi ini juga dapat mengembalikan kesalahan dari panggilan yang mendasarinya ke NotifyUnicastIpAddressChange,WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl, CreateThreadpoolIo, CreateThreadpoolCleanupGroup, dan CreateTimerQueue.

Keterangan

Transportasi UDP IPv6 default yang dibuat oleh fungsi ini khusus untuk DRT yang dibuatnya. Akibatnya tidak dapat digunakan kembali di beberapa DRT.

Saat menggunakan DISTRIBUTED Routing Table API di Windows XP dengan Paket Layanan 2 (SP2), dukungan protokol IPv6 harus diaktifkan agar pembuatan transportasi menggunakan DrtCreateIpv6UdpTransport berhasil.

Persyaratan


Klien minimum yang didukung	Windows 7 Professional [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	drt.h
Pustaka	Drttransport.lib
DLL	Drt.dll

Lihat juga

DRT_SETTINGS

DrtDeleteIpv6UdpTransport

Bagikan melalui