Fungsi MprConfigServerGetInfo (mprapi.h)

Artikel
02/29/2024

Fungsi MprConfigServerGetInfo mengambil informasi konfigurasi tingkat server untuk router yang ditentukan.

Sintaks

DWORD MprConfigServerGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [out] LPBYTE *lplpbBuffer
);

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 . Nilai yang dapat diterima untuk dwLevel mencakup 0, 1, dan 2 seperti yang tercantum dalam tabel berikut.

Nilai	Format Struktur
0	Windows 2000 Server atau yang lebih baru: MPR_SERVER_0
1	Windows Server 2003 atau yang lebih baru: MPR_SERVER_1
2	Windows Server 2008 atau yang lebih baru: MPR_SERVER_2

[out] lplpbBuffer

Setelah berhasil diselesaikan, pointer ke MPR_SERVER_0, MPR_SERVER_1,
atau struktur MPR_SERVER_2 . Parameter dwLevel menunjukkan jenis struktur. Kosongkan memori untuk buffer ini menggunakan MprConfigBufferFree.

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: Parameter hMprConfig adalah NULL. Parameter dwLevel bukan nol. Parameter lplpBuffer adalah NULL.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
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