Bagikan melalui


Fungsi NetAddAlternateComputerName (lmjoin.h)

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

Lihat juga

NetEnumerateComputerNames

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx