Fonction InitAtomTable (winbase.h)
Initialise la table atom locale et définit le nombre de compartiments de hachage à la taille spécifiée.
Syntaxe
BOOL InitAtomTable(
[in] DWORD nSize
);
Paramètres
[in] nSize
Type : DWORD
Nombre de compartiments de hachage à utiliser pour la table atom. Si ce paramètre est égal à zéro, le nombre par défaut de compartiments de hachage est créé.
Pour obtenir de meilleures performances, spécifiez un nombre premier dans nSize.
Valeur retournée
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Remarques
Une application n’a pas besoin d’utiliser cette fonction pour utiliser une table d’atomes locale. Le nombre par défaut de compartiments de hachage utilisés est 37. Toutefois, si une application utilise InitAtomTable, elle doit appeler la fonction avant toute autre fonction de gestion des atomes.
Si une application utilise un grand nombre d’atomes locaux, elle peut réduire le temps nécessaire pour ajouter un atome à la table d’atomes locale ou pour trouver un atome dans la table en augmentant la taille de la table. Toutefois, cela augmente la quantité de mémoire nécessaire à la maintenance de la table.
Le nombre de compartiments dans la table globale des atomes ne peut pas être modifié. Si la table atom a déjà été initialisée, soit explicitement par un appel antérieur à InitAtomTable, soit implicitement par l’utilisation d’une fonction de gestion des atomes, InitAtomTable retourne la réussite sans modifier le nombre de compartiments de hachage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |
Voir aussi
Référence