Fungsi DnsHostnameToComputerNameW (winbase.h)

2024-11-20

Mengonversi nama host bergaya DNS menjadi nama komputer bergaya NetBIOS.

Sintaksis

BOOL DnsHostnameToComputerNameW(
  [in]      LPCWSTR Hostname,
  [out]     LPWSTR  ComputerName,
  [in, out] LPDWORD nSize
);

Parameter

[in] Hostname

Nama DNS. Jika nama DNS bukan nama yang valid dan dapat diterjemahkan, fungsi gagal. Untuk informasi selengkapnya, lihat Nama Komputer.

[out] ComputerName

Penunjuk ke buffer yang menerima nama komputer. Ukuran buffer harus cukup besar untuk berisi MAX_COMPUTERNAME_LENGTH + 1 karakter.

[in, out] nSize

Pada input, menentukan ukuran buffer, dalam TCHAR. Pada output, menerima jumlah TCHAR disalin ke buffer tujuan, tidak termasuk karakter null yang mengakhiri.

Jika buffer terlalu kecil, fungsi gagal, GetLastError mengembalikan ERROR_MORE_DATA, dan nSize menerima ukuran buffer yang diperlukan, tidak termasuk karakter null yang mengakhiri.

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, panggil GetLastError. Nilai yang mungkin termasuk yang berikut ini.

Mengembalikan kode	Deskripsi
ERROR_MORE_DATA	Buffer ComputerName terlalu kecil. Parameter nSize berisi jumlah byte yang diperlukan untuk menerima nama.

Komentar

Fungsi ini melakukan pemetaan tekstual nama. Konvensi ini membatasi nama komputer menjadi subset umum dari nama. (Secara khusus, label paling kiri dari nama DNS dipotong menjadi 15 byte karakter OEM.) Oleh karena itu, jangan gunakan fungsi ini untuk mengonversi nama domain DNS menjadi nama domain NetBIOS. Tidak ada pemetaan tekstual untuk nama domain.

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

Nota

Header winbase.h mendefinisikan DnsHostnameToComputerName 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetComputerNameEx

SetComputerNameEx

Fungsi Informasi Sistem