Fungsi GlobalAddAtomExW (winbase.h)
Menambahkan string karakter ke tabel atom global dan mengembalikan nilai unik (atom) yang mengidentifikasi string.
Sintaks
ATOM GlobalAddAtomExW(
[in, optional] LPCWSTR lpString,
[in] DWORD Flags
);
Parameter
[in, optional] lpString
String yang dihentikan null yang akan ditambahkan. String dapat memiliki ukuran maksimum 255 byte. String yang hanya berbeda 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 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
Target Platform | Windows |
Header | winbase.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |