Fungsi MprConfigInterfaceEnum (mprapi.h)
Fungsi MprConfigInterfaceEnum menghitung antarmuka yang dikonfigurasi untuk router.
Sintaks
DWORD MprConfigInterfaceEnum(
[in] HANDLE hMprConfig,
[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] 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_INTERFACE_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 akan 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 untuk melanjutkan enumerasi.
Pada output, berisi handel resume yang dapat 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.
Mengembalikan 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
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 |