Fungsi GlobalDeleteAtom (winbase.h)
Mengurangi jumlah referensi atom string global. Jika jumlah referensi atom mencapai nol, GlobalDeleteAtom akan menghapus string yang terkait dengan atom dari tabel atom global.
Sintaks
ATOM GlobalDeleteAtom(
[in] ATOM nAtom
);
Parameter
[in] nAtom
Jenis: ATOM
String atom dan karakter yang akan dihapus.
Nilai kembali
Jenis: ATOM
Fungsi selalu mengembalikan (ATOM) 0.
Untuk menentukan apakah fungsi telah gagal, panggil SetLastError dengan ERROR_SUCCESS sebelum memanggil GlobalDeleteAtom, lalu panggil GetLastError. Jika kode kesalahan terakhir masih ERROR_SUCCESS, GlobalDeleteAtom telah berhasil.
Keterangan
Jumlah referensi atom string menentukan berapa kali string telah ditambahkan ke tabel atom. Fungsi GlobalAddAtom menambahkan jumlah referensi string yang sudah ada dalam tabel atom global setiap kali dipanggil.
Setiap panggilan ke GlobalAddAtom harus memiliki panggilan yang sesuai ke GlobalDeleteAtom. Jangan memanggil GlobalDeleteAtom lebih sering daripada yang Anda panggil GlobalAddAtom, atau Anda dapat menghapus atom saat klien lain menggunakannya. Aplikasi yang menggunakan Dynamic Data Exchange (DDE) harus mengikuti aturan tentang manajemen atom global untuk mencegah kebocoran dan penghapusan dini.
GlobalDeleteAtom tidak berpengaruh pada atom bilangan bulat (atom yang nilainya berada dalam rentang 0x0001 hingga 0xBFFF). Fungsi selalu mengembalikan nol untuk atom bilangan bulat.
Contoh
Misalnya, lihat Memulai Percakapan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 |
Lihat juga
Referensi