Fungsi MprAdminUserGetInfo (mprapi.h)
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 |
---|---|
|
Pemanggil tidak memiliki hak istimewa yang memadai. |
|
Nilai dwLevel tidak valid. |
|
lpbBuffer adalah NULL |
|
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 |