Funzione InitAtomTable (winbase.h)

Articolo
03/08/2023

Inizializza la tabella atom locale e imposta il numero di bucket hash sulle dimensioni specificate.

Sintassi

BOOL InitAtomTable(
  [in] DWORD nSize
);

Parametri

[in] nSize

Tipo: DWORD

Numero di bucket hash da usare per la tabella atom. Se questo parametro è zero, viene creato il numero predefinito di bucket hash.

Per ottenere prestazioni migliori, specificare un numero primo in nSize.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Un'applicazione non deve usare questa funzione per usare una tabella atom locale. Il numero predefinito di bucket hash usati è 37. Se un'applicazione usa InitAtomTable, tuttavia, deve chiamare la funzione prima di qualsiasi altra funzione di gestione atom.

Se un'applicazione usa un numero elevato di atomi locali, può ridurre il tempo necessario per aggiungere un atomo alla tabella atom locale o per trovare un atomo nella tabella aumentando le dimensioni della tabella. Tuttavia, questo aumenta la quantità di memoria necessaria per mantenere la tabella.

Impossibile modificare il numero di bucket nella tabella atom globale. Se la tabella atom è già stata inizializzata, in modo esplicito da una chiamata precedente a InitAtomTable o implicitamente dall'uso di qualsiasi funzione di gestione atom, InitAtomTable restituisce l'esito positivo senza modificare il numero di bucket hash.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll