Fungsi NetRenameMachineInDomain (lmjoin.h)

Artikel
03/14/2023

Fungsi NetRenameMachineInDomain mengubah nama komputer dalam domain.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpNewMachineName,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fRenameOptions
);

Parameter

[in] lpServer

Penunjuk ke string konstanta yang menentukan nama DNS atau NetBIOS komputer untuk memanggil fungsi. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] lpNewMachineName

Penunjuk ke string konstanta yang menentukan nama baru komputer. Jika ditentukan, nama komputer lokal juga diubah. Jika parameter ini NULL, fungsi mengasumsikan Anda telah memanggil fungsi SetComputerNameEx .

[in] lpAccount

Penunjuk ke string konstanta yang menentukan nama akun yang akan digunakan saat menyambungkan ke pengendali domain. Jika parameter ini NULL, konteks pemanggil akan digunakan.

[in] lpPassword

Jika parameter lpAccount menentukan nama akun, parameter ini harus menunjuk ke kata sandi yang akan digunakan saat menyambungkan ke pengendali domain. Jika tidak, parameter ini harus NULL.

[in] fRenameOptions

Opsi ganti nama. Jika parameter ini NETSETUP_ACCT_CREATE, fungsi akan mengganti nama akun di domain.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut atau salah satu kode kesalahan sistem.

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Akses ditolak. Kesalahan ini dikembalikan jika nama akun yang diteruskan dalam parameter lpAccount tidak memiliki hak akses yang memadai untuk operasi.
ERROR_INVALID_PARAMETER	Parameter salah.
NERR_SetupNotJoined	Komputer saat ini tidak tergabung ke domain.
NERR_SetupDomainController	Komputer ini adalah pengendali domain dan tidak dapat dilepas dari domain.

Keterangan

Mengganti nama komputer domain hanya dapat dilakukan oleh pengguna yang merupakan anggota grup lokal Administrator di komputer target dan itu juga merupakan anggota grup Administrator pada domain atau memiliki hak istimewa Operator Akun pada domain. Jika Anda memanggil fungsi NetRenameMachineInDomain dari jarak jauh, Anda harus memberikan kredensial karena Anda tidak dapat mendelegasikan kredensial dalam keadaan ini.

Proses yang berbeda, atau utas yang berbeda dari proses yang sama, tidak boleh memanggil fungsi NetRenameMachineInDomain secara bersamaan. Situasi ini dapat membuat komputer dalam keadaan tidak konsisten.

Nilai NERR_SetupNotJoined dan pengembalian NERR_SetupDomainController ditentukan dalam file header Lmerr.h. File header ini secara otomatis disertakan oleh file header Lm.h dan tidak boleh disertakan secara langsung.

Reboot sistem diperlukan setelah memanggil fungsi NetRenameMachineInDomain agar operasi selesai.

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