Fungsi MprAdminInterfaceEnum (mprapi.h)

Artikel
03/05/2024

Fungsi MprAdminInterfaceEnum menghitung semua antarmuka pada server tertentu.

Sintaks

DWORD MprAdminInterfaceEnum(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [in]  DWORD             dwPrefMaxLen,
  [out] LPDWORD           lpdwEntriesRead,
  [out] LPDWORD           lpdwTotalEntries,
  [in]  LPDWORD           lpdwResumeHandle
);

Parameter

[in] hMprServer

Tangani ke perute untuk menjalankan panggilan ini. Dapatkan handel ini dengan memanggil MprAdminServerConnect.

[in] dwLevel

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

[out] lplpbBuffer

Setelah berhasil diselesaikan, penunjuk ke array struktur MPR_INTERFACE_0 . Bebaskan buffer memori ini dengan memanggil MprAdminBufferFree.

[in] dwPrefMaxLen

Menentukan panjang maksimum data yang dikembalikan yang disukai (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 antarmuka yang dijumlahkan dari posisi saat ini dalam enumerasi.

[out] lpdwTotalEntries

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

[in] lpdwResumeHandle

Penunjuk ke variabel DWORD . Variabel ini menentukan handel resume yang dapat digunakan untuk melanjutkan enumerasi. Handel harus nol pada panggilan pertama, dan dibiarkan tidak berubah pada panggilan berikutnya. Jika kode pengembalian ERROR_MORE_DATA maka panggilan dapat dikeluarkan kembali menggunakan handel untuk mengambil lebih banyak data. Jika saat kembali, handel adalah NULL, enumerasi tidak dapat dilanjutkan. Untuk jenis pengembalian kesalahan lainnya, 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 NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_ACCESS_DENIED	Aplikasi panggilan tidak memiliki hak istimewa yang memadai.
ERROR_MORE_DATA	Informasi lebih lanjut tersedia; enumerasi dapat dilanjutkan.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NOT_SUPPORTED	Nilai dwLevel tidak valid.

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

MPR_INTERFACE_0

MprAdminBufferFree

MprAdminServerConnect

Fungsi Administrasi Perute

Referensi Manajemen Router

Bagikan melalui