Fungsi MprConfigInterfaceTransportEnum (mprapi.h)
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 |
---|---|
|
Salah satu hal berikut ini benar:
|
|
Sumber daya tidak cukup untuk menyelesaikan operasi. |
|
Tidak ada entri lain yang tersedia dari posisi resume saat ini. |
|
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 |