Fungsi NetServerComputerNameAdd (lmserver.h)

Artikel
03/04/2024

Fungsi NetServerComputerNameAdd menghitung transportasi tempat server yang ditentukan aktif, dan mengikat nama server yang ditiru ke setiap transportasi.

NetServerComputerNameAdd adalah fungsi utilitas yang menggabungkan fungsionalitas fungsi NetServerTransportEnum dan fungsi NetServerTransportAddEx .

Sintaks

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

Parameter

[in] ServerName

Penunjuk ke string yang menentukan nama server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] EmulatedDomainName

Penunjuk ke string yang berisi nama domain yang harus digunakan server yang ditentukan saat mengumumkan kehadirannya menggunakan EmulatedServerName. Parameter ini bersifat opsional.

[in] EmulatedServerName

Penunjuk ke string karakter yang dihentikan null yang berisi nama yang ditiru, server harus mulai mendukung selain nama yang ditentukan oleh parameter ServerName .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success. Perhatikan bahwa NetServerComputerNameAdd berhasil jika nama server yang ditiru yang ditentukan ditambahkan ke setidaknya satu transportasi.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pengguna tidak memiliki akses ke informasi yang diminta.
ERROR_DUP_NAME	Nama duplikat ada di jaringan.
ERROR_INVALID_DOMAINNAME	Nama domain tidak dapat ditemukan pada jaringan.
ERROR_INVALID_PARAMETER	Parameter yang ditentukan tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia.

Keterangan

Hanya anggota grup lokal Administrator atau Operator Server yang berhasil menjalankan fungsi NetServerComputerNameAdd .

Server yang ditentukan oleh parameter ServerName terus mendukung semua nama yang didukungnya, dan juga mulai mendukung nama baru yang disediakan oleh panggilan yang berhasil ke fungsi NetServerComputerNameAdd .

Emulasi nama yang dihasilkan dari panggilan ke NetServerComputerNameAdd berhenti saat server memulai ulang atau memulai ulang. Untuk menghentikan emulasi nama yang ditetapkan oleh panggilan sebelumnya ke NetServerComputerNameAdd tanpa memulai ulang atau me-reboot, Anda dapat memanggil fungsi NetServerComputerNameDel .

Fungsi NetServerComputerNameAdd biasanya digunakan ketika administrator sistem menggantikan server, tetapi ingin menjaga konversi tetap transparan kepada pengguna.

Contoh

Berikut ini adalah contoh panggilan ke fungsi NetServerComputerNameAdd yang meminta \Server1 juga menanggapi permintaan untuk \Server2.

NetServerComputerNameAdd (Server1, NULL, Server2);

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	lmserver.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll