Fungsi MprConfigInterfaceGetInfo (mprapi.h)

Artikel
08/24/2023

Fungsi MprConfigInterfaceGetInfo mengambil konfigurasi untuk antarmuka yang ditentukan dari router.

Sintaks

DWORD MprConfigInterfaceGetInfo(
  [in]      HANDLE  hMprConfig,
  [in]      HANDLE  hRouterInterface,
  [in]      DWORD   dwLevel,
  [in, out] LPBYTE  *lplpBuffer,
  [out]     LPDWORD lpdwBufferSize
);

Parameter

[in] hMprConfig

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

[in] hRouterInterface

Tangani ke konfigurasi antarmuka untuk mengambil informasi. Dapatkan handel ini dengan memanggil MprConfigInterfaceCreate, MprConfigInterfaceGetHandle, atau MprConfigInterfaceEnum.

[in] dwLevel

Nilai DWORD yang menjelaskan format di mana informasi dikembalikan dalam parameter lplpBuffer . 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

[in, out] lplpBuffer

Pada input, penunjuk non-NULL .

Setelah berhasil diselesaikan, penunjuk ke array MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2, atau struktur MPR_INTERFACE_3 . Parameter dwLevel menunjukkan jenis struktur. Bebaskan buffer ini dengan memanggil MprConfigBufferFree.

[out] lpdwBufferSize

Penunjuk ke variabel DWORD . Variabel ini menerima ukuran, dalam byte, dari data yang dikembalikan melalui lplpBuffer.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.

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

Nilai	Makna
ERROR_INVALID_PARAMETER	Setidaknya salah satu hal berikut ini benar: hMprConfig adalah NULL hRouterInterface adalah NULL dwLevel bukan 0, 1, 2, atau 3. lplpBuffer adalah NULL lpdwBufferSize adalah NULL
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NO_SUCH_INTERFACE	Antarmuka yang sesuai dengan hRouterInterface tidak ada dalam konfigurasi router.

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