Fungsi GlobalGetAtomNameA (winbase.h)

Artikel
08/27/2023

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

Sintaks

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

Parameter

[in] nAtom

Jenis: ATOM

Atom global yang terkait dengan string karakter yang akan diambil.

[out] lpBuffer

Jenis: LPTSTR

Buffer untuk 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 mengakhiri.

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 mencakup tidak menentukan ukuran parameter lpBuffer dengan benar. Perhatikan juga bahwa atom global dapat diakses oleh siapa saja; dengan demikian, privasi dan integritas isinya tidak terjaga.

Catatan

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