Fungsi MprConfigInterfaceTransportEnum (mprapi.h)

Artikel
03/15/2023

Fungsi MprConfigInterfaceTransportEnum menghitung transportasi yang dikonfigurasi pada antarmuka yang ditentukan.

Sintaks

DWORD MprConfigInterfaceTransportEnum(
  [in]                HANDLE  hMprConfig,
  [in]                HANDLE  hRouterInterface,
  [in]                DWORD   dwLevel,
  [in, out]           LPBYTE  *lplpBuffer,
  [in]                DWORD   dwPrefMaxLen,
  [out]               LPDWORD lpdwEntriesRead,
  [out]               LPDWORD lpdwTotalEntries,
  [in, out, optional] LPDWORD lpdwResumeHandle
);

Parameter

[in] hMprConfig

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

[in] hRouterInterface

Tangani ke konfigurasi antarmuka untuk menghitung transportasi. Dapatkan handel ini dengan memanggil MprConfigInterfaceCreate, atau MprConfigInterfaceEnum.

[in] dwLevel

Nilai DWORD yang menjelaskan format di mana informasi dikembalikan dalam parameter lplpBuffer . Harus nol.

[in, out] lplpBuffer

Pada input, penunjuk non-NULL .

Setelah berhasil diselesaikan, penunjuk ke array struktur MPR_IFTRANSPORT_0 . Bebaskan buffer memori ini dengan memanggil MprConfigBufferFree.

[in] dwPrefMaxLen

Menentukan panjang maksimum yang disukai dari data yang dikembalikan (dalam byte 8-bit). Jika parameter ini adalah -1, buffer yang dikembalikan cukup besar untuk menyimpan semua informasi yang tersedia.

[out] lpdwEntriesRead

Penunjuk ke variabel DWORD . Variabel ini menerima jumlah total entri yang dijumlahkan dari posisi resume saat ini.

[out] lpdwTotalEntries

Penunjuk ke variabel DWORD . Variabel ini menerima jumlah total entri yang dapat dijumlahkan dari posisi resume saat ini.

[in, out, optional] lpdwResumeHandle

Penunjuk ke variabel DWORD .

Pada input, handel harus nol pada panggilan pertama dan dibiarkan tidak berubah pada panggilan berikutnya.

Pada output, variabel ini berisi handel resume yang digunakan untuk melanjutkan enumerasi. Jika handel adalah NULL, enumerasi selesai.

Jika terjadi kesalahan dalam enumerasi, handel ini tidak valid.

Parameter ini bersifat opsional. Jika aplikasi panggilan menentukan NULL untuk parameter ini, fungsi tidak mengembalikan handel resume.

Menampilkan 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_INVALID_PARAMETER	Salah satu hal berikut ini benar: hMprConfig adalah NULL. HRouterInterface adalah NULL. dwLevel bukan nol. lplpBuffer adalah NULL. dwPrefMaxLen lebih kecil dari ukuran struktur MPR_IFTRANSPORT_0 tunggal. lpdwEntriesRead adalah NULL. lpdwTotalEntries adalah NULL.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NO_MORE_ITEMS	Tidak ada entri lain yang tersedia dari posisi resume saat ini.
Lainnya	Gunakan FormatMessage untuk mengambil pesan kesalahan sistem yang sesuai dengan kode kesalahan yang dikembalikan.

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