Fungsi GetAtomNameA (winbase.h)

Artikel
11/20/2024

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

Sintaksis

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 pengembalian adalah panjang string yang disalin ke buffer, dalam karakter, tidak termasuk karakter null yang mengakhiri.

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

Komentar

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

Pertimbangan Keamanan

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

Nota

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

AddAtom

DeleteAtom

FindAtom

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

GlobalGetAtomName

MAKEINTATOM

Referensi

Bagikan melalui