Fungsi GlobalDeleteAtom (winbase.h)

Artikel
03/03/2024

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