Fungsi MprAdminGetPDCServer (mprapi.h)

Artikel
03/15/2023

Fungsi MprAdminGetPDCServer mengambil nama server dengan Subsistem Akun Pengguna (UAS) master dari nama domain atau nama server. Baik parameter nama domain atau parameter nama server mungkin NULL, tetapi tidak keduanya.

Sintaks

DWORD MprAdminGetPDCServer(
  [in]  LPCWSTR lpszDomain,
  [in]  LPCWSTR lpszServer,
  [out] LPWSTR  lpszPDCServer
);

Parameter

[in] lpszDomain

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama domain tempat server RAS berada. Parameter ini bisa NULL jika Anda menjalankan aplikasi administrasi RAS Anda di server Windows NT/Windows 2000 yang tidak berpartisipasi dalam domain. Jika parameter ini NULL, parameter lpwsServerName tidak boleh NULL.

[in] lpszServer

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama server Windows NT/Windows 2000 RAS. Tentukan nama dengan karakter "\" di depannya, dalam formulir: \servername. Parameter ini dapat berupa NULL jika parameter lpwsDomain bukan NULL.

[out] lpszPDCServer

Penunjuk ke buffer yang menerima string Unicode yang dihentikan null yang berisi nama pengendali domain yang memiliki database akun pengguna. Buffer harus cukup besar untuk menahan nama server (UNCLEN +1). Fungsi ini mengawali nama server yang dikembalikan dengan karakter "\" terkemuka, dalam bentuk: \servername.

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_NO_SUCH_DOMAIN	Domain yang ditentukan tidak valid.
NERR_InvalidComputer	Parameter lpwsDomainName adalah NULL, dan parameter lpwsServerName tidak valid.

Keterangan

Fungsi MprAdminGetPDCServer dapat memperoleh nama server dengan database akun pengguna yang diberi nama server RAS, atau nama domain tempat server RAS berada. Untuk mendapatkan nama server, panggil fungsi GetComputerName

Jika nama server yang ditentukan oleh lpszServer adalah bagian dari domain, Server yang dikembalikan oleh MprAdminGetPDCServer akan menjadi pengendali domain utama atau pengendali domain cadangan.

Jika nama server yang ditentukan oleh lpszServer adalah server Windows NT/Windows 2000 yang berdiri sendiri (yaitu, server atau stasiun kerja tidak berpartisipasi dalam domain), maka nama server itu sendiri dikembalikan dalam buffer lpszUserAccountServer .

Anda kemudian dapat menggunakan nama server akun pengguna dalam panggilan ke fungsi NetQueryDisplayInformation untuk menghitung pengguna dalam database akun pengguna. Anda juga dapat menggunakan nama server dalam panggilan ke fungsi MprAdminUserGetInfo dan MprAdminUserSetInfo untuk mendapatkan dan mengatur hak istimewa RAS untuk akun pengguna tertentu.

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