Bagikan melalui

Fungsi GlobalAddAtomExA (winbase.h)

  • Artikel

Menambahkan string karakter ke tabel atom global dan mengembalikan nilai unik (atom) yang mengidentifikasi string.

Sintaks

ATOM GlobalAddAtomExA(
  [in, optional] LPCSTR lpString,
  [in]           DWORD  Flags
);

Parameter

[in, optional] lpString

String yang dihentikan null yang akan ditambahkan. String dapat memiliki ukuran maksimum 255 byte. String yang berbeda hanya jika dianggap identik. Kasus string pertama dari nama ini yang ditambahkan ke tabel dipertahankan dan dikembalikan oleh fungsi GlobalGetAtomName .

Atau, Anda dapat menggunakan atom bilangan bulat yang telah dikonversi menggunakan makro MAKEINTATOM . Lihat Keterangan untuk informasi selengkapnya.

[in] Flags

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah atom yang baru dibuat.

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

Keterangan

Catatan

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

   
Target Platform Windows
Header winbase.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

GlobalAddAtom