Fungsi MprAdminInterfaceTransportAdd (mprapi.h)

Artikel
03/15/2023

Fungsi MprAdminInterfaceTransportAdd menambahkan transportasi (misalnya, IP atau IPX) ke antarmuka tertentu.

Sintaks

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

Parameter

[in] hMprServer

Tangani ke perute tempat informasi ditambahkan. Dapatkan handel ini dengan memanggil MprAdminServerConnect.

[in] hInterface

Tangani ke antarmuka tempat transportasi ditambahkan. Handel ini diperoleh dengan panggilan sebelumnya ke MprAdminInterfaceCreate.

[in] dwTransportId

Nilai DWORD yang menjelaskan jenis transportasi untuk ditambahkan ke antarmuka. 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

[in] pInterfaceInfo

Penunjuk ke header informasi yang menentukan informasi antarmuka untuk transportasi ini. Gunakan Fungsi Header Informasi untuk memanipulasi header informasi.

[in] dwInterfaceInfoSize

Menentukan ukuran, dalam byte, dari informasi yang ditujukan oleh pInterfaceInfo.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

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

Nilai	Makna
ERROR_ACCESS_DENIED	Aplikasi panggilan tidak memiliki hak istimewa yang memadai.
ERROR_INVALID_HANDLE	Nilai hInterface tidak valid.
ERROR_INVALID_PARAMETER	Parameter pInterfaceInfo adalah NULL.
ERROR_UNKNOWN_PROTOCOL_ID	Nilai dwTransportId tidak cocok dengan transportasi yang didukung.

Keterangan

Parameter dwTransportId juga menentukan manajer router karena router menggunakan manajer router yang berbeda untuk setiap transportasi.

Persyaratan


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