Fungsi MprAdminUserSetInfo (mprapi.h)

Artikel
08/24/2023

Fungsi MprAdminUserSetInfo menetapkan informasi RAS untuk pengguna yang ditentukan.

Sintaks

DWORD MprAdminUserSetInfo(
  [in] LPCWSTR      lpszServer,
  [in] LPCWSTR      lpszUser,
  [in] DWORD        dwLevel,
  [in] const 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 pengontrol 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

Arahkan ke string Unicode yang menentukan nama pengguna untuk mengatur informasi RAS.

[in] dwLevel

Parameter ini bisa nol atau satu, sesuai dengan jenis struktur yang diacu oleh parameter lpbBuffer .

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

[in] lpbBuffer

Arahkan ke struktur RAS_USER_0 atau RAS_USER_1 yang menentukan informasi RAS baru untuk pengguna.

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

Menampilkan nilai

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.
_INVALID_LEVEL KESALAHAN	Nilai dwLevel tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NO_SUCH_USER	Pengguna yang ditentukan oleh lpwsUserName tidak ada di server yang ditentukan oleh lpwsServerName.

Keterangan

Fungsi ini tersedia pada Windows NT 4.0 jika RRAS redistributable diinstal. Namun, versi Mprapi.dll yang dikirim dengan RRAS redistributable mengekspor fungsi sebagai RasAdminUserSetInfo daripada MprAdminUserSetInfo. Oleh karena itu, saat menggunakan RRAS redistributable, gunakan LoadLibrary dan GetProcAddress untuk mengakses fungsi ini.

Persyaratan


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