Fungsi MprAdminUserGetInfo (mprapi.h)

Artikel
02/29/2024

Fungsi MprAdminUserGetInfo mengambil semua informasi RAS untuk pengguna tertentu.

Sintaks

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

Parameter

[in] lpszServer

Penunjuk ke string Unicode yang menentukan nama server dengan Subsistem Akun Pengguna (UAS) master. Jika server akses jarak jauh adalah bagian dari domain, komputer dengan UAS adalah pengendali domain utama atau pengendali domain cadangan. Jika server akses jarak jauh bukan bagian dari domain, maka server itu sendiri menyimpan UAS. Dalam kedua kasus, panggil fungsi MprAdminGetPDCServer untuk mendapatkan nilai untuk parameter ini.

Jika server itu sendiri menyimpan UAS, parameter ini bisa NULL.

[in] lpszUser

Penunjuk ke string Unicode yang menentukan nama pengguna untuk mendapatkan informasi RAS.

[in] dwLevel

Parameter ini mungkin nol atau satu.

Windows NT Server 4.0 dengan SP3 dan yang lebih baru: Parameter ini harus nol.

[out] lpbBuffer

Arahkan ke struktur RAS_USER_0 atau RAS_USER_1 . Pemanggil harus mengalokasikan (dan membebaskan) memori untuk struktur ini. Setelah berhasil dikembalikan, struktur ini berisi data RAS untuk pengguna yang ditentukan.

Windows NT Server 4.0 dengan SP3 dan yang lebih baru: Jika parameter dwLevel menentukan nol, lpbBuffer harus menunjuk ke struktur RAS_USER_0 .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

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

Nilai	Makna
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki hak istimewa yang memadai.
ERROR_INVALID_LEVEL	Nilai dwLevel tidak valid.
ERROR_INVALID_PARAMETER	lpbBuffer adalah NULL
ERROR_NO_SUCH_USER	Pengguna yang ditentukan oleh lpwsUserName tidak ada di server yang ditentukan oleh lpwsServerName.

Keterangan

Fungsi ini tersedia di Windows NT 4.0 jika RRAS redistributable diinstal. Namun, versi Mprapi.dll yang dikirim dengan RRAS redistributable mengekspor fungsi sebagai RasAdminUserGetInfo daripada MprAdminUserGetInfo. Oleh karena itu, saat menggunakan RRAS yang dapat didistribusikan ulang, gunakan LoadLibrary dan GetProcAddress untuk mengakses fungsi ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mprapi.h
Pustaka	Mprapi.lib
DLL	Mprapi.dll