Fungsi GetAtomNameA (winbase.h)

Artikel
03/08/2023

Mengambil salinan string karakter yang terkait dengan atom lokal yang ditentukan.

Sintaks

UINT GetAtomNameA(
  [in]  ATOM  nAtom,
  [out] LPSTR lpBuffer,
  [in]  int   nSize
);

Parameter

[in] nAtom

Jenis: ATOM

Atom lokal yang mengidentifikasi string karakter yang akan diambil.

[out] lpBuffer

Jenis: LPTSTR

String karakter.

[in] nSize

Jenis: int

Ukuran, dalam karakter, dari buffer.

Mengembalikan nilai

Jenis: UINT

Jika fungsi berhasil, nilai yang dikembalikan adalah panjang string yang disalin ke buffer, dalam karakter, tidak termasuk karakter null yang dihentikan.

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

Keterangan

String yang dikembalikan untuk atom bilangan bulat (atom yang nilainya berada dalam rentang 0x0001 ke 0xBFFF) adalah string yang diakhiri null di mana karakter pertama adalah tanda pagar (#) dan karakter yang tersisa mewakili nilai atom bilangan bulat yang tidak ditandatangani.

Pertimbangan Keamanan

Menggunakan fungsi ini secara tidak benar dapat membahayakan keamanan program Anda. Penggunaan fungsi ini yang salah termasuk tidak menentukan ukuran parameter lpBuffer dengan benar.

Catatan

Header winbase.h mendefinisikan GetAtomName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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


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