InitAtomTable-Funktion (winbase.h)

Artikel
03/06/2024

Initialisiert die lokale Atomtabelle und legt die Anzahl der Hashbuckets auf die angegebene Größe fest.

Syntax

BOOL InitAtomTable(
  [in] DWORD nSize
);

Parameter

[in] nSize

Art: DWORD

Die Anzahl der Hashbuckets, die für die Atomtabelle verwendet werden sollen. Wenn dieser Parameter null ist, wird die Standardanzahl von Hashbuckets erstellt.

Um eine bessere Leistung zu erzielen, geben Sie eine Primzahl in nSize an.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Eine Anwendung muss diese Funktion nicht verwenden, um eine lokale Atomtabelle zu verwenden. Die Standardanzahl der verwendeten Hashbuckets ist 37. Wenn eine Anwendung Jedoch InitAtomTable verwendet, sollte sie die Funktion vor jeder anderen Atomverwaltungsfunktion aufrufen.

Wenn eine Anwendung eine große Anzahl von lokalen Atomen verwendet, kann die Zeit reduziert werden, die zum Hinzufügen eines Atoms zur lokalen Atomtabelle oder zum Suchen eines Atoms in der Tabelle erforderlich ist, indem die Größe der Tabelle erhöht wird. Dies erhöht jedoch die Menge an Arbeitsspeicher, die zum Verwalten der Tabelle erforderlich ist.

Die Anzahl der Buckets in der globalen Atomtabelle kann nicht geändert werden. Wenn die Atomtabelle bereits initialisiert wurde, entweder explizit durch einen vorherigen Aufruf von InitAtomTable oder implizit durch die Verwendung einer beliebigen Atomverwaltungsfunktion, gibt InitAtomTable den Erfolg zurück, ohne die Anzahl der Hashbuckets zu ändern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll