Bagikan melalui


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
ERROR_INVALID_PARAMETER
Setidaknya salah satu hal berikut ini benar:
  • hMprConfig adalah NULL.
  • dwLevel bukan nol.
  • lplpBuffer adalah NULL.
  • dwPrefMaxLen lebih kecil dari ukuran struktur MPR_TRANSPORT_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

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

Lihat juga

FormatMessage

MprConfigBufferFree

MprConfigServerConnect

Fungsi Konfigurasi Router

Referensi Manajemen Router