Función InitAtomTable (winbase.h)

Artículo
03/03/2024

Inicializa la tabla atom local y establece el número de cubos hash en el tamaño especificado.

Sintaxis

BOOL InitAtomTable(
  [in] DWORD nSize
);

Parámetros

[in] nSize

Tipo: DWORD

Número de cubos hash que se van a usar para la tabla atom. Si este parámetro es cero, se crea el número predeterminado de cubos hash.

Para lograr un mejor rendimiento, especifique un número primo en nSize.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Una aplicación no necesita usar esta función para usar una tabla atom local. El número predeterminado de cubos hash usados es 37. Sin embargo, si una aplicación usa InitAtomTable, debe llamar a la función antes de cualquier otra función de administración de atom.

Si una aplicación usa un gran número de átomos locales, puede reducir el tiempo necesario para agregar un átomo a la tabla atom local o para encontrar un átomo en la tabla aumentando el tamaño de la tabla. Sin embargo, esto aumenta la cantidad de memoria necesaria para mantener la tabla.

No se puede cambiar el número de cubos de la tabla atom global. Si la tabla atom ya se ha inicializado, ya sea explícitamente mediante una llamada anterior a InitAtomTable o implícitamente por el uso de cualquier función de administración de atom, InitAtomTable devuelve éxito sin cambiar el número de cubos hash.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll