Fungsi SetComputerNameExA (sysinfoapi.h)

Artikel
08/26/2023

Mengatur nama NetBIOS atau DNS baru untuk komputer lokal. Perubahan nama yang dibuat oleh SetComputerNameEx tidak berlaku sampai pengguna memulai ulang komputer.

Sintaks

BOOL SetComputerNameExA(
  [in] COMPUTER_NAME_FORMAT NameType,
  [in] LPCSTR               lpBuffer
);

Parameter

[in] NameType

Jenis nama yang akan ditetapkan. Parameter ini bisa menjadi salah satu nilai berikut dari jenis enumerasi COMPUTER_NAME_FORMAT .

Nilai	Makna
ComputerNamePhysicalDnsDomain	Mengatur akhiran DNS utama komputer.
ComputerNamePhysicalDnsHostname	Mengatur NetBIOS dan Nama Komputer (label pertama dari nama DNS lengkap) ke nama yang ditentukan dalam lpBuffer. Jika nama melebihi karakter MAX_COMPUTERNAME_LENGTH, nama NetBIOS dipotong menjadi MAX_COMPUTERNAME_LENGTH karakter, tidak termasuk karakter null yang mengakhiri.
ComputerNamePhysicalNetBIOS	Mengatur nama NetBIOS ke nama yang ditentukan dalam lpBuffer. Nama tidak boleh melebihi MAX_COMPUTERNAME_LENGTH karakter, tidak termasuk karakter null yang mengakhiri. Peringatan: Menggunakan opsi ini untuk mengatur nama NetBIOS memutus konvensi nama NetBIOS dan DNS yang saling bergantung. Aplikasi yang menggunakan fungsi DnsHostnameToComputerName untuk mendapatkan nama NetBIOS dari label pertama nama DNS akan gagal jika konvensi ini rusak.

[in] lpBuffer

Nama baru. Nama tidak boleh menyertakan karakter kontrol, spasi di depan atau di belakang, atau salah satu karakter berikut: " / \ [ ] : | <> + = ; , ?

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

SetComputerNameEx dapat mengatur Nama Komputer (label pertama dari nama DNS lengkap) atau akhiran DNS utama komputer lokal. Ini tidak dapat mengatur nama DNS yang sepenuhnya memenuhi syarat dalam satu panggilan.

Jika komputer lokal adalah simpul dalam kluster, SetComputerNameEx mengatur NetBIOS atau nama DNS komputer lokal, bukan dari server virtual kluster.

Proses yang memanggil fungsi SetComputerNameEx harus memiliki hak istimewa administrator di komputer lokal.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0500 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Catatan

Header sysinfoapi.h mendefinisikan SetComputerNameEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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	sysinfoapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll