Fungsi MprAdminServerGetInfo (mprapi.h)

Artikel
03/05/2024

Fungsi MprAdminServerGetInfo mengambil informasi tentang server RRAS yang ditentukan.

Sintaks

DWORD MprAdminServerGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Parameter

[in] hMprServer

Tangani ke router untuk mengkueri. Dapatkan handel ini dengan memanggil MprAdminServerConnect.

[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, penunjuk ke MPR_SERVER_0, MPR_SERVER_1,
atau struktur MPR_SERVER_2 . Parameter dwLevel menunjukkan jenis struktur. Bebaskan memori untuk buffer ini menggunakan MprAdminBufferFree

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_ACCESS_DENIED	Aplikasi panggilan tidak memiliki hak istimewa yang memadai.
ERROR_INVALID_PARAMETER	Parameter lplpbBuffer adalah NULL.
RPC_S_INVALID_BINDING	Parameter hMprServer adalah NULL.

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