Fungsi MprAdminInterfaceGetInfo (mprapi.h)

Artikel
08/24/2023

Fungsi MprAdminInterfaceGetInfo mengambil informasi untuk antarmuka tertentu pada server tertentu.

Sintaks

DWORD MprAdminInterfaceGetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            *lplpbBuffer
);

Parameter

[in] hMprServer

Tangani ke router untuk mengkueri. Handel ini diperoleh dari panggilan sebelumnya ke MprAdminServerConnect.

[in] hInterface

Tangani ke antarmuka yang diperoleh oleh panggilan sebelumnya ke MprAdminInterfaceCreate.

[in] dwLevel

Nilai DWORD yang menjelaskan format di mana informasi disusun dalam parameter lplpbBuffer . Nilai yang dapat diterima untuk dwLevel mencakup 0, 1, 2, dan 3, seperti yang tercantum dalam tabel berikut.

Nilai	Format Struktur
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 atau yang lebih baru: MPR_INTERFACE_3

Nilai 1, 2, dan 3 hanya berlaku untuk antarmuka jenis ROUTER_CONNECTION_STATE.

[in] lplpbBuffer

Penunjuk ke MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2, atau struktur MPR_INTERFACE_3 . Parameter dwLevel menunjukkan jenis struktur. Bebaskan memori ini dengan memanggil MprAdminBufferFree.

Nilai kembali

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_LEVEL	dwLevel adalah 2, tetapi tingkat tersebut tidak didukung untuk antarmuka. Misalnya, jenis antarmuka, seperti yang didefinisikan dalam struktur MPR_INTERFACE_X, tidak IF_TYPE_FULL_ROUTER.
ERROR_INVALID_HANDLE	Nilai hInterface tidak valid.
ERROR_INVALID_PARAMETER	Parameter lplpbBuffer adalah NULL.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NOT_SUPPORTED	Nilai dwLevel tidak valid.

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