InitAtomTable-Funktion (winbase.h)
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 |
Siehe auch
Referenz