Fungsi MprConfigInterfaceTransportGetHandle (mprapi.h)

Artikel
03/15/2023

Fungsi MprConfigInterfaceTransportGetHandle mengambil handel ke konfigurasi transportasi antarmuka dalam konfigurasi router yang ditentukan.

Sintaks

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

Parameter

[in] hMprConfig

Tangani ke konfigurasi router. Dapatkan handel ini dengan memanggil MprConfigServerConnect.

[in] hRouterInterface

Menangani konfigurasi antarmuka. Dapatkan handel ini dengan memanggil MprConfigInterfaceCreate, MprConfigInterfaceGetHandle, atau MprConfigInterfaceEnum.

[in] dwTransportId

Nilai DWORD yang menjelaskan jenis handel konfigurasi transportasi dalam parameter phRouterIfTransport . Nilai yang dapat diterima untuk dwTransportId tercantum dalam tabel berikut.

Nilai	Transportasi (Keluarga Protokol)
PID_ATALK	Appletalk
PID_IP	Protokol Internet versi 4
PID_IPX	Pertukaran Paket Internet
PID_NBF	Protokol Bingkai NetBIOS
PID_IPV6	Windows Server 2008 atau yang lebih baru: Protokol Internet versi 6

[out] phRouterIfTransport

Penunjuk ke
Variabel HANDLE yang menerima jenis handel konfigurasi transportasi untuk antarmuka ini yang ditunjukkan dalam parameter dwTransportId .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Setidaknya salah satu hal berikut ini benar: hMprConfig adalah NULL. hRouterInterface adalah NULL. phRouterIfTransport adalah NULL.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NO_SUCH_INTERFACE	Antarmuka yang ditentukan oleh hRouterInterface tidak ditemukan dalam konfigurasi perute, atau transportasi yang ditentukan oleh dwTransportId tidak diaktifkan pada antarmuka yang ditentukan.
Lainnya	Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mprapi.h
Pustaka	Mprapi.lib
DLL	Mprapi.dll