Fungsi GlobalGetAtomNameA (winbase.h)

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

Sintaksis

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 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. Selain itu, perhatikan bahwa atom global dapat diakses oleh siapa saja; dengan demikian, privasi dan integritas isinya tidak diyakinkan.

Nota

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

MAKEINTATOM

Referensi