Fungsi MprConfigTransportCreate (mprapi.h)
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 |
---|---|
|
Parameter hMprConfig adalah NULL, atau parameter phRouterTransport adalah NULL, atau keduanya adalah NULL. |
|
Sumber daya tidak cukup untuk menyelesaikan operasi. |
|
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 |