Fungsi NetAddAlternateComputerName (lmjoin.h)

Artikel
08/24/2023

Fungsi NetAddAlternateComputerName menambahkan nama alternatif untuk komputer yang ditentukan.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetAddAlternateComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR AlternateName,
  [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] AlternateName

Penunjuk ke string konstanta yang menentukan nama alternatif untuk ditambahkan. 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 AlternateName 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 NetAddAlternateComputerName didukung pada Windows XP dan yang lebih baru.

Fungsi NetAddAlternateComputerName digunakan untuk mengatur nama jaringan sekunder untuk komputer. Nama utama adalah nama yang digunakan untuk autentikasi dan peta ke nama akun komputer.

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

Persyaratan


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