Fungsi MprConfigTransportSetInfo (mprapi.h)

Artikel
03/15/2023

Fungsi MprConfigTransportSetInfo mengubah konfigurasi untuk protokol transportasi yang ditentukan dalam konfigurasi router yang ditentukan.

Sintaks

DWORD MprConfigTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterTransport,
  [in, optional] LPBYTE pGlobalInfo,
  [in, optional] DWORD  dwGlobalInfoSize,
  [in, optional] LPBYTE pClientInterfaceInfo,
  [in, optional] DWORD  dwClientInterfaceInfoSize,
  [in, optional] LPWSTR lpwsDLLPath
);

Parameter

[in] hMprConfig

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

[in] hRouterTransport

Tangani konfigurasi protokol transportasi yang sedang diperbarui. Dapatkan handel ini dengan memanggil MprConfigTransportCreate, MprConfigTransportGetHandle, atau MprConfigTransportEnum. Jenis protokol transportasi yang didukung tercantum di Pengidentifikasi Transportasi.

[in, optional] pGlobalInfo

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

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

[in, optional] dwGlobalInfoSize

Menentukan ukuran, dalam byte, dari data yang ditujukkan oleh pGlobalInfo. Jika aplikasi panggilan menentukan NULL untuk pGlobalInfo, aplikasi panggilan harus menentukan nol untuk parameter ini.

[in, optional] pClientInterfaceInfo

Penunjuk ke header informasi yang menentukan informasi antarmuka default untuk router klien. Informasi ini digunakan untuk mengonfigurasi antarmuka dinamis untuk router 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, dari data yang diacu oleh 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.

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

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR. Untuk informasi selengkapnya, lihat bagian Keterangan nanti dalam topik ini.

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

Nilai	Makna
ERROR_INVALID_PARAMETER	Parameter hMprConfig adalah NULL, parameter hRouterTransport adalah NULL, atau keduanya adalah NULL.
ERROR_UNKNOWN_PROTOCOL_ID	Konfigurasi protokol transportasi yang sesuai dengan hRouterTransport tidak ditemukan dalam konfigurasi perute.
Lainnya	Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

Keterangan

Gunakan MprConfigTransportSetInfo untuk mengatur informasi global transportasi, informasi antarmuka default, atau nama DLL manajer router untuk transportasi.

MprConfigTransportSetInfo mencoba mengatur item dalam urutan munculnya item dalam daftar parameter:

Informasi global.
Informasi antarmuka default untuk router klien.
Nama DLL manajer router.

Jika MprConfigTransportSetInfo tidak dapat mengatur salah satu item, MprConfigSetInfo akan segera kembali tanpa mencoba mengatur item yang tersisa.

Jika parameter pGlobalInfo, pClientInterfaceInfo, dan lpwsDLLPath semuanya NULL, fungsi tidak melakukan apa pun, mengembalikan nilai NO_ERROR.

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