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

Voir aussi

AddAtom

DeleteAtom

FindAtom

GetAtomName

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

GlobalGetAtomName

Référence