Fungsi MprAdminTransportGetInfo (mprapi.h)

Artikel
03/15/2023

Fungsi MprAdminTransportGetInfo mengambil informasi global, informasi antarmuka klien default, atau keduanya, untuk transportasi tertentu.

Sintaks

DWORD MprAdminTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            DWORD             dwTransportId,
  [out, optional] LPBYTE            *ppGlobalInfo,
  [out, optional] LPDWORD           lpdwGlobalInfoSize,
  [out, optional] LPBYTE            *ppClientInterfaceInfo,
  [out, optional] LPDWORD           lpdwClientInterfaceInfoSize
);

Parameter

[in] hMprServer

Tangani ke perute dari mana informasi sedang diambil. Handel ini diperoleh dari panggilan sebelumnya ke MprAdminServerConnect.

[in] dwTransportId

Nilai DWORD yang menjelaskan jenis transportasi yang akan diambil. 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, optional] ppGlobalInfo

Penunjuk ke variabel penunjuk. Variabel ini menunjuk ke header informasi yang menerima informasi global untuk transportasi ini. Gunakan Fungsi Header Informasi untuk memanipulasi header informasi.

Bebaskan memori ini dengan memanggil MprAdminBufferFree.

Parameter ini bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk parameter ini, fungsi tidak mengambil informasi global.

[out, optional] lpdwGlobalInfoSize

Penunjuk ke variabel DWORD . Variabel ini menerima ukuran, dalam byte, dari informasi global untuk transportasi.

[out, optional] ppClientInterfaceInfo

Penunjuk ke variabel penunjuk. Variabel ini menunjuk ke informasi antarmuka klien default untuk transportasi ini. Bebaskan memori ini dengan memanggil MprAdminBufferFree.

Parameter ini bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk parameter ini, fungsi tidak mengambil informasi antarmuka klien.

[out, optional] lpdwClientInterfaceInfoSize

Penunjuk ke variabel DWORD . Variabel ini menerima ukuran, dalam byte, dari informasi antarmuka klien.

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_PARAMETER	Salah satu hal berikut ini benar: Parameter ppGlobalInfo dan parameter ppClientInterfaceInfo keduanya adalah NULL. Parameter ppGlobalInfo tidak menunjuk ke memori yang valid. Parameter ppClientInterfaceInfo tidak menunjuk ke memori yang valid.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_UNKNOWN_PROTOCOL_ID	Nilai dwTransportId tidak cocok dengan transportasi yang diinstal.

Keterangan

Parameter ppGlobalInfo dan ppClientInterfaceInfo tidak boleh keduanya NULL.

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