Fungsi MprConfigTransportEnum (mprapi.h)
Fungsi MprConfigTransportEnum menghitung transportasi yang dikonfigurasi pada router.
Sintaks
DWORD MprConfigTransportEnum(
[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 untuk transportasi. 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_TRANSPORT_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.
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.
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 |
---|---|
|
Setidaknya 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 |