Fungsi NetSetPrimaryComputerName (lmjoin.h)

Artikel
08/24/2023

Fungsi NetSetPrimaryComputerName mengatur nama komputer utama untuk komputer yang ditentukan.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR PrimaryName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

Parameter

[in, optional] Server

Penunjuk ke string konstanta yang menentukan nama komputer untuk menjalankan fungsi ini. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] PrimaryName

Penunjuk ke string konstanta yang menentukan nama utama yang akan diatur. Nama ini harus dalam bentuk nama DNS yang sepenuhnya memenuhi syarat.

[in, optional] DomainAccount

Penunjuk ke string konstanta yang menentukan akun domain yang akan digunakan untuk mengakses objek akun komputer untuk komputer yang ditentukan dalam parameter Server di Direktori Aktif. Jika parameter ini NULL, kredensial pengguna yang menjalankan rutinitas ini digunakan.

Parameter ini tidak digunakan jika server untuk menjalankan fungsi ini tidak bergabung ke domain.

[in, optional] DomainAccountPassword

Penunjuk ke string konstanta yang menentukan kata sandi yang cocok dengan akun domain yang diteruskan dalam parameter DomainAccount . Jika parameter ini NULL, kredensial pengguna yang menjalankan rutinitas ini digunakan.

Parameter ini diabaikan jika parameter DomainAccount ADALAH NULL. Parameter ini tidak digunakan jika server untuk menjalankan fungsi ini tidak bergabung ke domain.

[in] Reserved

Disiapkan untuk penggunaan masa mendatang. Parameter ini harus NULL.

Nilai kembali

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 penelepon bukan anggota grup lokal Administrator pada komputer target.
ERROR_INVALID_NAME	Parameter nama salah. Kesalahan ini dikembalikan jika parameter PrimaryName tidak berisi nama yang valid.
ERROR_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika parameter DomainAccount tidak berisi domain yang valid. Kesalahan ini juga dikembalikan jika parameter DomainAccount bukan NULL dan parameter DomainAccountPassword bukan NULL tetapi tidak berisi string Unicode.
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia untuk memproses perintah ini.
ERROR_NOT_SUPPORTED	Permintaan tidak didukung. Kesalahan ini dikembalikan jika komputer target yang ditentukan dalam parameter Server tempat fungsi ini dijalankan berjalan pada Windows 2000 dan yang lebih lama.
NERR_WkstaNotStarted	Layanan Stasiun Kerja belum dimulai.
RPC_S_CALL_IN_PROGRESS	Panggilan prosedur jarak jauh sudah berlangsung untuk utas ini.
RPC_S_PROTSEQ_NOT_SUPPORTED	Urutan protokol panggilan prosedur jarak jauh tidak didukung.

Keterangan

Fungsi NetSetPrimaryComputerName didukung pada Windows XP dan yang lebih baru.

Fungsi NetSetPrimaryComputerName digunakan sebagai bagian dari operasi penggantian nama komputer. Nama yang ditentukan akan dihapus dari daftar nama alternatif yang dikonfigurasi untuk komputer target dan dikonfigurasi sebagai nama utama. Nama akun komputer akan diubah agar sesuai dengan nama utama. Nama komputer utama sebelumnya dipindahkan ke daftar nama komputer alternatif yang dikonfigurasi untuk komputer.

Fungsi NetSetPrimaryComputerName mengharuskan pemanggil adalah anggota grup lokal Administrator di komputer target.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	lmjoin.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll