Fungsi InitAtomTable (winbase.h)
Menginisialisasi tabel atom lokal dan mengatur jumlah wadah hash ke ukuran yang ditentukan.
Sintaks
BOOL InitAtomTable(
[in] DWORD nSize
);
Parameter
[in] nSize
Jenis: DWORD
Jumlah wadah hash yang akan digunakan untuk tabel atom. Jika parameter ini nol, jumlah default wadah hash dibuat.
Untuk mencapai performa yang lebih baik, tentukan bilangan prima di nSize.
Nilai kembali
Jenis: BOOL
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Aplikasi tidak perlu menggunakan fungsi ini untuk menggunakan tabel atom lokal. Jumlah default wadah hash yang digunakan adalah 37. Namun, jika aplikasi menggunakan InitAtomTable, aplikasi harus memanggil fungsi sebelum fungsi manajemen atom lainnya.
Jika aplikasi menggunakan sejumlah besar atom lokal, aplikasi dapat mengurangi waktu yang diperlukan untuk menambahkan atom ke tabel atom lokal atau menemukan atom dalam tabel dengan meningkatkan ukuran tabel. Namun, ini meningkatkan jumlah memori yang diperlukan untuk mempertahankan tabel.
Jumlah wadah dalam tabel atom global tidak dapat diubah. Jika tabel atom telah diinisialisasi, baik secara eksplisit dengan panggilan sebelumnya ke InitAtomTable, atau secara implisit dengan penggunaan fungsi manajemen atom apa pun, InitAtomTable mengembalikan keberhasilan tanpa mengubah jumlah wadah hash.
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