Fungsi RasAdminGetUserAccountServer

[Fungsi ini disediakan hanya untuk kompatibilitas mundur dengan Windows NT Server 4.0. Ini mengembalikan ERROR_CALL_NOT_IMPLEMENTED pada Windows Server 2003. Aplikasi harus menggunakan fungsi MprAdminGetPDCServer .]

Fungsi RasAdminGetUserAccountServer mengambil nama server yang memiliki database akun pengguna. Gunakan nama server yang dikembalikan di fungsi RasAdminUserGetInfo dan RasAdminUserSetInfo untuk mendapatkan atau mengatur informasi tentang pengguna tertentu.

Sintaks

DWORD RasAdminGetUserAccountServer(
  _In_  const WCHAR  *lpszDomain,
  _In_  const WCHAR  *lpszServer,
  _Out_       LPWSTR lpszUserAccountServer
);

Parameter

lpszDomain [in]

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama domain tempat server RAS berada. Parameter ini adalah NULL untuk aplikasi administrasi RAS yang berjalan di stasiun kerja atau server yang bukan anggota domain. Jika parameter ini NULL, parameter lpszServer harus non-NULL.

lpszServer [in]

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama server RAS. Tentukan nama dengan karakter "\\" di depannya, dalam formulir: \\servername. Parameter ini bisa NULL jika parameter lpszDomain bukan NULL.

lpszUserAccountServer [out]

Penunjuk ke buffer yang menerima string Unicode yang dihentikan null yang menentukan 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.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan bisa menjadi kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	Baik lpszDomain maupun lpszServer adalah NULL.

Tidak ada informasi kesalahan yang diperluas untuk fungsi ini; jangan panggil GetLastError.

Keterangan

Fungsi RasAdminGetUserAccountServer mendapatkan nama server dengan database akun pengguna. Fungsi ini memerlukan nama server RAS atau nama domain tempat server RAS berada.

Parameter lpszDomain harus menentukan nama domain yang valid. Parameter ini adalah NULL untuk aplikasi administrasi RAS yang berjalan di server yang bukan anggota domain (misalnya, server berada dalam grup kerjanya sendiri). Dalam hal ini, parameter lpszServer harus menentukan nama server. Untuk mendapatkan nama server, panggil fungsi GetComputerName . Pastikan untuk mengawali nama server dengan karakter "\\".

Jika nama server yang ditentukan oleh lpszServer adalah server yang berdiri sendiri (yaitu, server atau stasiun kerja bukan anggota domain), maka nama server itu sendiri dikembalikan dalam buffer lpszUserAccountServer .

Kemudian gunakan nama server akun pengguna dalam panggilan ke fungsi NetQueryDisplayInformation untuk menghitung pengguna dalam database akun pengguna.

Persyaratan

Persyaratan	Nilai
Akhir dukungan klien	Windows 2000 Professional
Akhir dukungan server	Windows 2000 Server
Header	Rassapi.h
Pustaka	Rassapi.lib
DLL	Rassapi.dll

Lihat juga

Gambaran Umum Layanan Akses Jarak Jauh (RAS)

Fungsi Administrasi Server RAS

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo