Fungsi MprAdminInterfaceTransportGetInfo (mprapi.h)

Artikel
03/15/2023

Fungsi MprAdminInterfaceTransportGetInfo mengambil informasi tentang transportasi yang berjalan pada antarmuka tertentu.

Sintaks

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

Parameter

[in] hMprServer

Tangani ke perute dari mana informasi sedang diambil. Dapatkan handel ini dengan memanggil MprAdminServerConnect.

[in] hInterface

Tangani ke antarmuka. Handel ini diperoleh dari panggilan sebelumnya ke MprAdminInterfaceCreate.

[in] dwTransportId

Nilai DWORD yang menjelaskan transportasi yang informasinya diminta. 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] ppInterfaceInfo

Penunjuk ke variabel penunjuk. Variabel pointer menunjuk ke header informasi yang menerima informasi untuk antarmuka dan transportasi yang ditentukan. Gunakan Fungsi Header Informasi untuk memanipulasi header informasi. Bebaskan memori ini dengan memanggil MprAdminBufferFree.

[out, optional] lpdwInterfaceInfoSize

Penunjuk ke variabel DWORD . Variabel ini menerima ukuran dalam byte informasi antarmuka yang dikembalikan melalui parameter ppInterfaceInfo .

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

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan 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, atau jika antarmuka yang ditentukan dinonaktifkan secara administratif.
ERROR_NO_SUCH_INTERFACE	Transportasi yang ditentukan tidak berjalan pada antarmuka yang ditentukan.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_UNKNOWN_PROTOCOL_ID	Nilai dwTransportId tidak cocok dengan transportasi yang didukung.

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

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

Fungsi Administrasi Perute

Referensi Manajemen Router

Bagikan melalui