Fungsi MprConfigTransportCreate (mprapi.h)

Artikel
03/15/2023

Fungsi MprConfigTransportCreate menambahkan transportasi yang ditentukan ke daftar protokol transportasi yang ada dalam konfigurasi router yang ditentukan.

Sintaks

DWORD MprConfigTransportCreate(
  [in]           HANDLE hMprConfig,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pGlobalInfo,
  [in]           DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath,
  [out]          HANDLE *phRouterTransport
);

Parameter

[in] hMprConfig

Tangani ke konfigurasi router untuk menambahkan transportasi. Dapatkan handel ini dengan memanggil MprConfigServerConnect.

[in] dwTransportId

Nilai DWORD yang menjelaskan transportasi untuk ditambahkan ke konfigurasi. Parameter ini juga mengidentifikasi manajer router untuk transportasi. 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, optional] lpwsTransportName

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama transportasi yang ditambahkan. Jika parameter ini tidak ditentukan, parameter dwTransportId dikonversi menjadi string dan digunakan sebagai nama transportasi.

[in] pGlobalInfo

Penunjuk ke header informasi yang menentukan informasi global untuk transportasi. Manajer router untuk transportasi menginterpretasikan informasi ini. Gunakan Fungsi Header Informasi untuk memanipulasi header informasi.

[in] dwGlobalInfoSize

Menentukan ukuran, dalam byte, data yang ditujukkan oleh parameter pGlobalInfo .

[in, optional] pClientInterfaceInfo

Penunjuk ke header informasi yang menentukan informasi antarmuka default untuk router klien. Informasi ini digunakan untuk mengonfigurasi antarmuka dinamis untuk perute klien untuk transportasi ini. Gunakan Fungsi Header Informasi untuk memanipulasi header informasi.

Parameter ini bersifat opsional; aplikasi panggilan dapat menentukan NULL untuk parameter ini.

[in, optional] dwClientInterfaceInfoSize

Menentukan ukuran, dalam byte, data yang diacu oleh parameter pClientInterfaceInfo . Jika aplikasi panggilan menentukan NULL untuk pClientInterfaceInfo, aplikasi panggilan harus menentukan nol untuk parameter ini.

[in, optional] lpwsDLLPath

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama DLL manajer router untuk transportasi yang ditentukan. Jika nama ini ditentukan, fungsi akan mengatur jalur DLL untuk transportasi ini ke nama ini.

Parameter ini bersifat opsional; aplikasi panggilan dapat menentukan NULL untuk parameter ini.

[out] phRouterTransport

Penunjuk ke
Variabel HANDLE yang menerima jenis handel konfigurasi transportasi 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	Parameter hMprConfig adalah NULL, atau parameter phRouterTransport adalah NULL, atau keduanya adalah NULL.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
Lainnya	Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

Keterangan

Jika transportasi yang ditentukan sudah ada, MprConfigTransportCreate setara dengan panggilan MprConfigTransportSetInfo menggunakan nilai parameter yang disediakan.

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

Lihat juga

FormatMessage

MprConfigServerConnect

Fungsi Konfigurasi Router

Referensi Manajemen Router

Bagikan melalui